bun publish CLI 用法

bun publish dist

發布選項

--accessstring

--access 標志可用於設置要發布的包的訪問級別。訪問級別可以是 public 或 restricted 之一。非作用域包始終是公開的，嘗試使用 --access restricted 發布非作用域包會導致錯誤。

bun publish --access public

--access 也可以在 package.json 的 publishConfig 字段中設置。

{
  "publishConfig": {
    "access": "restricted"
  }
}

--tagstring default: latest

設置要發布的包版本的標簽。默認情況下，標簽為 latest。包的初始版本始終會被賦予 latest 標簽以及指定的標簽。

bun publish --tag alpha

--tag 也可以在 package.json 的 publishConfig 字段中設置。

{
  "publishConfig": {
    "tag": "next"
  }
}

--dry-run=<val>string

--dry-run 標志可用於模擬發布過程而不實際發布包。這對於驗證已發布包的內容而不實際發布包非常有用。

bun publish --dry-run

--gzip-levelstring default: 9

指定打包包時使用的 gzip 壓縮級別。僅適用於不帶 tarball 路徑參數的 bun publish。值范圍為 0 到 9（默認為 9）。

--auth-typestring default: web

如果您的 npm 賬戶啟用了 2FA，bun publish 將提示您輸入一次性密碼。這可以通過瀏覽器或 CLI 完成。--auth-type 標志可用於告訴 npm 注冊表您首選的方法。可能的值為 web 和 legacy，默認為 web。

bun publish --auth-type legacy
...
此操作需要一次性密碼。
輸入 OTP: 123456
...

--otpstring default: web

直接向 CLI 提供一次性密碼。如果密碼有效，這將在發布前跳過額外的一次性密碼提示。使用示例：

bun publish --otp 123456

NOTE

bun publish 尊重 NPM_CONFIG_TOKEN 環境變量，該變量可在 GitHub Actions 或自動化工作流中發布時使用。

注冊表配置

自定義注冊表

--registrystring

指定注冊表 URL，覆蓋 .npmrc 和 bunfig.toml

bun publish --registry https://my-private-registry.com

SSL 證書

--castring

提供證書頒發機構簽名證書

--cafilestring

證書頒發機構證書文件路徑

bun publish --ca "-----BEGIN CERTIFICATE-----..."

bun publish --cafile ./ca-cert.pem

發布選項

依賴管理

-p, --productionboolean

不安裝開發依賴

--omitstring

排除依賴類型：dev、optional 或 peer

-f, --forceboolean

始終從注冊表請求最新版本並重新安裝所有依賴

腳本控制

--ignore-scriptsboolean

打包和發布期間跳過生命周期腳本

--trustboolean

將包添加到 trustedDependencies 並運行其腳本

NOTE

**生命周期腳本** — 提供預構建的 tarball 時，不會執行生命周期腳本（prepublishOnly、prepack 等）。只有當 Bun 自己打包包時才會運行腳本。

文件管理

--no-saveboolean

不更新 package.json 或鎖文件

--frozen-lockfileboolean

不允許更改鎖文件

--yarnboolean

生成 yarn.lock 文件（yarn v1 兼容）

性能

--backendstring

平台優化：clonefile（默認）、hardlink、symlink 或 copyfile

--network-concurrencynumber default: 48

最大並發網絡請求數

--concurrent-scriptsnumber default: 5

最大並發生命周期腳本數

輸出控制

--silentboolean

抑制所有輸出

--verboseboolean

顯示詳細日志

--no-progressboolean

隱藏進度條

--no-summaryboolean

不打印發布摘要