Question

指令

启动伺服器

启动一个开发伺服器，并在你更动档案时自动重新编译 app，其也支援模组热替换以利快速开发。

parcel index.html

你也可以使用 glob 来指定多个进入点

parcel one.html two.html
# 或
parcel *.html
# 或
parcel ./**/*.html

编译

一次性编译资源，启用程式码压缩并设定环境变数 NODE_ENV 设定为 production。详情请见 正式环境一章。

parcel build index.html

_注：_ 在某些特殊使用情境下，是可以在 development 环境中执行单次编译的，像是：

NODE_ENV=development parcel build <entrypoint> --no-minify

他会产生与 serve 指令相同的 bundle，但不会启用监看及伺服器。

监看

watch 指令与 serve 类似，主要差异为此指令不会启动开发伺服器。

parcel watch index.html

帮助

显示所有 CLI 选项。

parcel help

版本

显示 Parcel 版本。

parcel --version

选项

输入路径

预设值： "dist"

适用指令： serve、watch 及 build

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

root
- build
- - output
- - - entry.js

设定要启动服务的 URL

预设值："/"

适用指令： serve、watch 及 build

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

此选项将会输出

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

目标

预设值： browser

适用指令： serve、watch 及 build

parcel build entry.js --target node

⚠️ node 与 electron 并不会打包 package.json 中的 dependencies（但会打包 devDependencies），此行为可用 --bundle-node-modules 来覆写，详见下方说明。

其他目标值：node、browser 及 electron

强制编译 node 模组

预设值：false

适用指令： serve、watch 及 build

parcel build entry.js --target node --bundle-node-modules

当使用 --target node 或 --target electron 这两个选项时，package.json 中的 dependencies 预设不会被打包。此选项可将其加入 bundle 中。

快取路径

预设值： ".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	纪录错误、警告与一般资讯
4	显示附带时间戳记的详尽 (Verbose) 讯息， 并纪录所有连至开发伺服器的请求
5	除错 (Debug)，将所有讯息输出至档案并附加时间戳记

模组热替换 (HMR) 主机名称

预设值：目前视窗的 location.hostname 值

适用指令： serve 及 watch

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

模组热替换 (HMR) 连接埠

预设值：随机的可用连接埠

适用指令： serve 及 watch

parcel entry.js --hmr-port 8080

输出档名

预设值：原档名

适用指令： serve、watch 及 build

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

这会改变入口 bundle 的档名

显示细节报告

预设：精简报告，否则细节深度为10

选填的参数可指定显示报告的深度。

适用指令： build

parcel build entry.js --detailed-report
parcel build entry.js --detailed-report 10

启用 HTTPS

预设：停用 HTTPS

适用指令： serve 及 watch (使用 HTTPS 监听模组热替换的连线)

parcel build entry.js --https

⚠️ 此选项将会产生一个自签凭证，你可能需要设定你的浏览器，使其允许本机环境中的自签凭证。

设定自有凭证

预设：停用 HTTPS

适用指令： serve 及 watch

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

在浏览器中开启

预设：不开启

适用指令： serve

parcel entry.js --open

停用 source-maps

预设：启用 source-maps

适用指令： serve、watch 及 build

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

停用内容 hash

预设：启用内容 hash

是用指令： build

parcel build entry.js --no-content-hash

停用自动安装

预设：启用自动安装

适用指令： serve 及 watch

parcel entry.js --no-autoinstall

停用模组热替换

预设：启用模组热替换

适用指令： serve 及 watch

parcel entry.js --no-hmr

停用程式码压缩

预设：启用压缩

适用指令： build

parcel build entry.js --no-minify

停用档案系统快取

预设：启用快取

适用指令： serve、watch 及 build

parcel build entry.js --no-cache

将模组汇出为 UMD

预设：停用

适用指令： serve、watch 及 build

parcel serve entry.js --global myvariable

启用实验性的 scope hoisting/tree shaking 功能

预设：停用

适用指令： build

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

详情请参阅 Devon Govett 文章的中的 Tree Shaking 小节。