bun pm コマンドグループは、Bun のパッケージマネージャーを操作するための一連のユーティリティを提供します。

pack

現在のワークスペースの tarball を作成するには:

bun pm pack

このコマンドは npm pack と同じルールに従って、npm に公開されるすべてのファイルを含む .tgz ファイルを作成します。

例

基本的な使用方法:

bun pm pack
# 現在のディレクトリに my-package-1.0.0.tgz を作成

スクリプト用のサイレントモード:

TARBALL=$(bun pm pack --quiet)
echo "作成：$TARBALL"

作成：my-package-1.0.0.tgz

カスタム保存先:

bun pm pack --destination ./dist
# ./dist/ ディレクトリに tarball を保存

オプション

• --dry-run: tarball をディスクに書き込むことを除くすべてのタスクを実行。何が含まれるかを表示します。
• --destination <dir>: tarball を保存するディレクトリを指定。
• --filename <name>: tarball の正確なファイル名を指定。
• --ignore-scripts: pre/postpack および prepare スクリプトの実行をスキップ。
• --gzip-level <0-9>: gzip のカスタム圧縮レベルを 0 から 9 の範囲で設定（デフォルトは 9）。
• --quiet: 詳細出力を抑制し、tarball ファイル名のみを出力。スクリプトや自動化に最適です。

注: --filename と --destination は同時に使用できません。

出力モード

デフォルト出力:

bun pm pack

bun pack v1.2.19

packed 131B package.json
packed 40B index.js

my-package-1.0.0.tgz

合計ファイル数：2
Shasum: f2451d6eb1e818f500a791d9aace80b394258a90
展開サイズ：171B
パックサイズ：249B

サイレント出力:

bun pm pack --quiet

my-package-1.0.0.tgz

--quiet フラグは、生成された tarball ファイル名をキャプチャしてさらに処理する必要がある自動化ワークフローで特に役立ちます。

bin

ローカルプロジェクトの bin ディレクトリへのパスを出力するには:

bun pm bin

/path/to/current/project/node_modules/.bin

グローバル bin ディレクトリへのパスを出力するには:

bun pm bin -g

<$HOME>/.bun/bin

ls

現在のプロジェクトにインストールされた依存関係と解決されたバージョンを、それらの依存関係を除いて一覧表示します。

bun pm ls
# または
bun list

/path/to/project node_modules (135)
├── eslint@8.38.0
├── react@18.2.0
├── react-dom@18.2.0
├── typescript@5.0.4
└── zod@3.21.4

n 次の依存関係を含む、すべてのインストールされた依存関係を一覧表示するには:

bun pm ls --all
# または
bun list --all

/path/to/project node_modules (135)
├── @eslint-community/eslint-utils@4.4.0
├── @eslint-community/regexpp@4.5.0
├── @eslint/eslintrc@2.0.2
├── @eslint/js@8.38.0
├── @nodelib/fs.scandir@2.1.5
├── @nodelib/fs.stat@2.0.5
├── @nodelib/fs.walk@1.2.8
├── acorn@8.8.2
├── acorn-jsx@5.3.2
├── ajv@6.12.6
├── ansi-regex@5.0.1
├── ...

whoami

npm ユーザー名を出力します。bunfig.toml または .npmrc の認証情報でログインしている必要があります（bunx npm login）。

bun pm whoami

hash

現在のロックファイルのハッシュを生成して出力します。

bun pm hash

ロックファイルのハッシュに使用される文字列を出力するには:

bun pm hash-string

現在のロックファイルに保存されているハッシュを出力するには:

bun pm hash-print

cache

Bun のグローバルモジュールキャッシュへのパスを出力するには:

bun pm cache

Bun のグローバルモジュールキャッシュをクリアするには:

bun pm cache rm

migrate

何もインストールせずに他のパッケージマネージャーのロックファイルを移行するには:

bun pm migrate

untrusted

スクリプトを持つ現在の信頼されていない依存関係を出力するには:

bun pm untrusted

./node_modules/@biomejs/biome @1.8.3
 » [postinstall]: node scripts/postinstall.js

これらの依存関係のライフサイクルスクリプトは、インストール中にブロックされました。

trust

信頼されていない依存関係のスクリプトを実行し、trustedDependencies に追加するには:

bun pm trust <names>

trust コマンドのオプション:

• --all: すべての信頼されていない依存関係を信頼します。

default-trusted

デフォルトの信頼された依存関係リストを出力するには:

bun pm default-trusted

GitHub での現在のリストは こちら を参照してください。

version

現在のパッケージバージョンを表示し、ヘルプを表示するには:

bun pm version

bun pm version v1.3.3 (ca7428e9)
現在のパッケージバージョン：v1.0.0

インクリメント:
  patch      1.0.0 → 1.0.1
  minor      1.0.0 → 1.1.0
  major      1.0.0 → 2.0.0
  prerelease 1.0.0 → 1.0.1-0
  prepatch   1.0.0 → 1.0.1-0
  preminor   1.0.0 → 1.1.0-0
  premajor   1.0.0 → 2.0.0-0
  from-git   最新の git タグからバージョンを使用
  1.2.3      特定のバージョンを設定

オプション:
  --no-git-tag-version git 操作をスキップ
  --allow-same-version バージョンが同じ場合のエラーのスローを防止
  --message=<val>, -m  カスタムコミットメッセージ、バージョン置換には %s を使用
  --preid=<val>        プリリース識別子（例：beta → 1.0.1-beta.0）
  --force, -f          ダーティ git 履歴チェックをバイパス

例:
  bun pm version patch
  bun pm version 1.2.3 --no-git-tag-version
  bun pm version prerelease --preid beta --message "リリース beta: %s"

package.json のバージョンをアップするには:

bun pm version patch

v1.0.1

patch、minor、major、premajor、preminor、prepatch、prerelease、from-git、または 1.2.3 のような特定のバージョンをサポートします。デフォルトでは git コミットとタグを作成しますが、--no-git-tag-version を使用してスキップできます。

pkg

get、set、delete、fix 操作で package.json データを管理します。

すべてのコマンドはドット表記とブラケット表記をサポートしています。

scripts.build              # ドット表記
contributors[0]            # 配列アクセス
workspaces.0               # ドットと数値インデックス
scripts[test:watch]        # 特殊文字用のブラケット

例:

# get
bun pm pkg get name                               # 単一プロパティ
bun pm pkg get name version                       # 複数のプロパティ
bun pm pkg get                                    # package.json 全体
bun pm pkg get scripts.build                      # ネストされたプロパティ

# set
bun pm pkg set name="my-package"                  # 単純なプロパティ
bun pm pkg set scripts.test="jest" version=2.0.0  # 複数のプロパティ
bun pm pkg set {"private":"true"} --json          # --json フラグで JSON 値

# delete
bun pm pkg delete description                     # 単一プロパティ
bun pm pkg delete scripts.test contributors[0]    # 複数/ネストされたプロパティ

# fix
bun pm pkg fix                                    # 一般的な問題を自動修正