🖥 CLI

指令

啟動伺服器

啟動一個開發伺服器，並在你更動檔案時自動重新編譯 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，此行為可用 --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

主機位置

預設值：localhost

適用指令： serve

parcel serve entry.js --host local.myhost.co.uk

連接埠

預設值：1234

適用指令： serve

parcel serve entry.js --port 1111

變更紀錄等級

預設值：3

適用指令： serve、watch 及 build

parcel entry.js --log-level 1

模組熱替換 (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 小節。

協助我們讓本文件更加完善

若有什麼內容遺漏了或是敘述不清楚的地方，請在本站的 repository 中開啟一個 issue 或者編輯此頁面。