命令行配置项
--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.json
的include
路径中包含Rollup
配置文件。
--environmnet <values>
通过process.ENV
传递其他设置到配置文件
rollup -c --environment INCLUDE_DEPS, BUILD:productions
将设置process.env.INCLUDE_DEPS === true
和process.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"
,或者message
为This 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
当其源文件在磁盘上发生变化的时候重新打包。