🖥 CLI

Commands

服务

serve 命令开启一个开发服务器,此服务器支持 模块热替换 以实现快速开发;当你更改文件时,该服务器将自动重新构建你的应用程序。

parcel index.html

构建(Build)

build 命令会一次性构建资源,它还启用了压缩功能,并设置了 NODE_ENV=production 环境变量。详见生产环境

parcel build index.html

监听(Watch)

watch 命令与 serve 命令类似,主要区别在于它并不会启动服务器。

parcel watch index.html

帮助(Help)

尽可能的显示所有 cli 的选项

parcel help

版本号

显示 Parcel 的版本号

parcel --version

参数

设置输出目录

默认为:"dist"

可用于:servewatchbuild

parcel build entry.js --out-dir build/output
# 或者
parcel build entry.js -d build/output
root
- build
- - output
- - - entry.js

设置要提供服务的公共 URL

默认为:与 --out-dir 参数一致

可用于:servewatchbuild

parcel entry.js --public-url ./dist/

将输出到:

<link rel="stylesheet" type="text/css" href="/dist/entry.1a2b3c.css">
<!-- 或者 -->
<script src="/dist/entry.e5f6g7.js"></script>

目标(Target)

默认为:browser

可用于:servewatchbuild

parcel build entry.js --target node

可选的目标(target):node、browserelectron`

缓存目录

默认值:".cache"

可用范围:serve, watch, build

parcel build entry.js --cache-dir build/cache

端口

默认值:1234

可用范围:serve

parcel serve entry.js --port 1111

更改日志级别

默认为:3

可用于:serve, watch, build

parcel entry.js --log-level 1
日志等级 效果
0 禁用记录
1 只记录错误
2 记录错误和警告
3 记录一切

HMR 主机名

默认为:当前 window 的 location.hostname

可用于:servewatch

parcel entry.js --hmr-hostname parceljs.org

HMR 端口

默认为:可访问的随机端口

可用于:serve, watch

parcel entry.js --hmr-port 8080

输出的文件名

默认为:源文件名称

可用于:servewatchbuild

parcel build entry.js --out-file output.html

这改变了入口 bundle 的输出文件名。

打印详细的报告

默认为:精简报告

可用于:build

parcel build entry.js --detailed-report

开启 https

默认值:禁止 https

可用范围:serve, watch (为 HMR 连接监听 HTTPS 请求)

parcel build entry.js --https

⚠️ 此参数将生成一个自签名证书,你还需要设置浏览器使其允许 localhost 使用自签名证书。

设置一个自定义证书

默认为:禁止 https

可用范围:serve, watch

parcel entry.js --cert certificate.cert --key private.key

在浏览器中打开

默认为:禁用打开

可用于:serve

parcel entry.js --open

禁用 source-maps

默认为:source-maps 已启用

可用于:servewatchbuild

parcel build entry.js --no-source-maps

禁用 autoinstall

默认为:autoinstall 已启用

可用于:servewatch

parcel entry.js --no-autoinstall

禁用 HMR

默认为:HMR 启用

可用于:servewatch

parcel entry.js --no-hmr

禁用 minification

默认为:minification 已启用

可用于:build

parcel build entry.js --no-minify

禁用文件系统缓存

默认为:缓存启用

可用于:serve, watch, build

parcel build entry.js --no-cache

将模块导出为 UMD 格式

默认值:disabled

可用范围:serve, watch, build

parcel serve entry.js --global myvariable

开启实验性的 scope hoisting/tree shaking 支持

默认值:disabled

可用范围:build

parcel build entry.js --experimental-scope-hoisting

更多信息请参考 Devon Govett 关于 Parcel 1.9 的文章中的Tree Shaking 章节