Rollup中文文档-基本命令行

20 阅读3分钟

命令行配置项

--bundleConfigAsCjs

此选项将强制你的配置文件转译为CommonJS。 这允许你在配置中使用CommonJS的变量和方法。例如:__dirname或者require.resolve,即使配置本身是作为ES模块编写。

--configPlugin <plugin>

允许指定Rollup插件来转译或者控制解析配置文件。主要好处是可以使用非Javascript的配置文件。例如,如果使用@rollup/plugin-typescript,则以下内容将允许你使用typescript来编写配置文件。

rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript

对于Typescript,请确保在tsconfig.jsoninclude路径中包含Rollup配置文件。

--environmnet <values>

通过process.ENV传递其他设置到配置文件

rollup -c --environment INCLUDE_DEPS, BUILD:productions

将设置process.env.INCLUDE_DEPS === trueprocess.env.BUILD === 'prodcution'。你可以多次使用此选项。在这种情况下,后续设置的变量将覆盖先前的定义。这是你可以覆盖package.json脚本中的环境变量。

{
    script: {
        build: "rollup -c --environment INCLUDE_DEPS, BUILD:production"
    }
}

通过以下方式去调用此脚本:

npm run build -- --environment BUILD:developmen
--failAfterWarnings

该配置设置Rollup一旦构建完成,如果出现任何警告,则以错误退出构建。

--filterLogs <filter>

根据自定义过滤可以仅展示特定的日志。一个过滤最基本的形式是value:key键值对的方式。其中key是日志对象的属性,而value是允许的值。例如:

rollup -c --filterLogs code:EVAL

仅会展示log.code === 'EVAL'的日志消息。可以通过使用逗号分割他们或多次使用该选项指定多个过滤器:

rollup -c --filterLogs "code:FOO,message:This is the message" --filterLogs code:BAR

上面配置仅展示所有code"Foo"或者"BAR",或者messageThis is the message的日志。

文档中还有过滤器的一些高级用法,可以直接移步Rollup中文文档

--forceExit
  • 执行完毕后强制退出进程。在某些情况下,插件或者依赖可能无法正确清理并阻止CLI进程退出。根据原因很难诊断,而此标志提供了一个逃生出口,直到并解决该问题。
-h / --help

打印帮助文档。

-p <plugin>, --plugin <plugin>

使用指定的插件。在此处指定插件的方式有多种。

  • 通过相对路径的方式:
// my.plugin.js导出一个返回插件对象的函数。
rollup i input.js -f es -p ./my-plugin.js
  • 通过在本地或全局的node_modules文件夹中安装的插件名称: 如果插件名称不以rollup-plugin或者@rollup/plugin-开头,Rollup将会自动添加这些前缀。
rollup -i input.js -f es -p @rollup/plugin-node-resolve

如果想加载多个插件,可以使用逗号进行分割。

--slient

该配置不要将警告打印到控制台。如果你的配置文件包含onLog或者onwarn处理程序,则仍将调用此处理程序。对于具有onLog勾子的插件也是如此。为了防止这种情况,另外使用logLevel选项或传递--logLevel slient

--stdin=ext

stdin读取内容时,指定虚拟文件扩展名。默认情况,Rollup将使用虚拟文件名-,没有扩展名,用于从stdin读取的内容。但是一些插件依赖于文件扩展名来确定是否处理文件。

--no-stdin

不用从stdin读取文件。设置此标志将防止内容传输到Rollup并确保Rollup将

-v/--version

查看版本号。

--waitForBundleInput

如果入口点文件中有个文件不可用,这不会引发错误。相反,在开始构建之前,它将等待所有文件都存在。这在监视模式下特别有用,当Rollup正在使用另一个进程的输入时。

-w / --watch

当其源文件在磁盘上发生变化的时候重新打包。