bun publish CLI 使用法

bun publish dist

公開オプション

--accessstring

--access フラグを使用して、公開中のパッケージのアクセスレベルを設定できます。アクセスレベルは public または restricted のいずれかです。スコープなしパッケージは常に public であり、--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

.npmrc と bunfig.toml をオーバーライドするレジストリ URL を指定します

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

公開サマリーを出力しません