• ? CLI
    • Commands
      • 服务（Serve）
      • 构建（Build）
      • 监听（Watch）
      • 帮助（Help）
      • 版本（Version）
    • Options
      • 设置输出目录
      • 设置要提供服务的公共 URL
      • 目标（Target）
      • 强制 node 模块打包
      • 缓存目录
      • 端口
      • 更改日志级别
      • HMR 主机名
      • HMR 端口
      • 输出的文件名
      • 打印详细的报告
      • 启用 https
      • 设置一个自定义证书
      • 在浏览器中打开
      • 禁用源代码映射（source-maps）
      • 禁用文件 hash 命名（content-hash）
      • 禁用自动安装依赖（autoinstall）
      • 禁用热替换（HMR）
      • 禁用代码压缩（minification）
      • 禁用文件系统缓存
      • UMD 方式暴露模块
      • 开启实验性的 scope hoisting/tree shaking 支持
    • 帮助我们改善文档

    ? CLI

    Commands

    服务（Serve）

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

    1. parcel index.html

    你也可以为多个入口点传递一个glob或 glob 列表。

    1. parcel one.html two.html
    2. # 或
    3. parcel *.html
    4. # 或
    5. parcel ./**/*.html

    构建（Build）

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

    1. parcel build index.html

    注意: 对于特殊用例，它也可以从开发环境执行单次构建：

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

    产生与serve相同的打包，但是没有监听或资源服务。

    监听（Watch）

    监听（watch）命令与服务器类似，主要区别在于它并不会启动服务器。

    1. parcel watch index.html

    帮助（Help）

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

    1. parcel help

    版本（Version）

    显示 Parcel 版本号

    1. parcel --version

    Options

    设置输出目录

    默认为："dist"

    可用于：serve，watch，build

    1. parcel build entry.js --out-dir build/output
    2. # 或者
    3. parcel build entry.js -d build/output
    1. root
    2. - build
    3. - - output
    4. - - - entry.js

    设置要提供服务的公共 URL

    默认为："/"

    可用于：serve，watch，build

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

    将输出到：

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

    目标（Target）

    默认为：browser

    可用于：serve，watch，build

    1. parcel build entry.js --target node

    ⚠️ Target 为node and electron的将不会打包dependencies（然而却包含devDependencies）。使用—bundle-node-modules 标记可以覆盖这样的行为（往下看）

    可选的目标（target）：node, browser, electron

    强制 node 模块打包

    默认为：false

    可用于： serve, watch, build

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

    默认情况下，当使用 —target node 或 —target electron时，package.json's dependencies将不包含在打包中。这个标记就是为了添加它们进去。

    缓存目录

    默认为: ".cache"

    可用于： serve, watch, build

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

    端口

    默认为：1234

    可用于： serve

    1. parcel serve entry.js --port 1111

    更改日志级别

    默认为：3

    可用于：serve, watch, build

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

    HMR 主机名

    默认为：当前 window 的 location.hostname

    可用于：serve，watch

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

    HMR 端口

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

    可用于：serve, watch

    1. parcel entry.js --hmr-port 8080

    输出的文件名

    默认为：源文件名称

    可用于：serve，watch，build

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

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

    打印详细的报告

    默认为：精简报告

    可选参数指定要打印报告的深度（depth）

    可用于：build

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

    启用 https

    默认为：不启用 https

    可用于： serve，watch（热更新 hmr 采用 https 连接）

    1. parcel entry.js --https

    ⚠️ 这个配置会生成一个自签名证书，你可能需要配置你的浏览器，使之接受 localhost 上的自签名证书。

    设置一个自定义证书

    默认为：不启用 https

    可用于：serve，watch

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

    在浏览器中打开

    默认为：禁用

    可用于：serve

    1. parcel entry.js --open

    禁用源代码映射（source-maps）

    默认为：启用

    可用于：serve，watch，build

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

    禁用文件 hash 命名（content-hash）

    默认为：启用

    可用于：build

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

    禁用自动安装依赖（autoinstall）

    默认为：启用

    可用于：serve，watch

    1. parcel entry.js --no-autoinstall

    禁用热替换（HMR）

    默认为：启用

    可用于：serve，watch

    1. parcel entry.js --no-hmr

    禁用代码压缩（minification）

    默认为：启用

    可用于：build

    1. parcel build entry.js --no-minify

    禁用文件系统缓存

    默认为：缓存启用

    可用于：serve, watch, build

    1. parcel build entry.js --no-cache

    UMD 方式暴露模块

    默认为：禁止

    可用于：serve, watch, build

    1. parcel serve entry.js --global myvariable

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

    默认为：禁止

    可用于：build

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

    更多信息，请查看 Devon Govett's post on Parcel 1.9Tree Shaking section

    帮助我们改善文档

    如果有遗漏或者不清楚的地方，请在本站的仓库 提交issue 或者 编辑此页面.