bun add

要添加特定包：

terminal

bun add preact

要指定版本、版本范围或标签：

terminal

bun add zod@3.20.0
bun add zod@^3.0.0
bun add zod@latest

`--dev`

别名 — --development、-d、-D

要将包添加为开发依赖（"devDependencies"）：

terminal

bun add --dev @types/react
bun add -d @types/react

`--optional`

要将包添加为可选依赖（"optionalDependencies"）：

terminal

bun add --optional lodash

`--peer`

要将包添加为对等依赖（"peerDependencies"）：

terminal

bun add --peer @types/bun

`--exact`

别名 — -E

要将包固定到已解析的版本，请使用 --exact。Bun 会将精确版本号写入 package.json，而不是版本范围。

terminal

bun add react --exact
bun add react -E

package.json 中的区别：

package.json

{
  "dependencies": {
    // 不使用 --exact
    "react": "^18.2.0", // 这匹配 >= 18.2.0 < 19.0.0

    // 使用 --exact
    "react": "18.2.0" // 这只精确匹配 18.2.0
  }
}

要查看此命令的完整选项列表：

terminal

bun add --help

`--global`

别名 — bun add --global、bun add -g、bun install --global 和 bun install -g

要全局安装包，请使用 -g/--global 标志。这不会修改当前项目的 package.json。用于安装命令行工具。

terminal

bun add --global cowsay # 或 `bun add -g cowsay`
cowsay "Bun!"

 ______
< Bun! >
 ------
        \   ^__^
         \  (oo)\_______
            (__)\       )\/\
                ||----w |
                ||     ||

配置全局安装行为

bunfig.toml

[install]
# `bun add --global` 安装包的位置
globalDir = "~/.bun/install/global"

# 全局安装的包 bin 被链接到的位置
globalBinDir = "~/.bun/bin"

可信依赖

与其他 npm 客户端不同，Bun 不会为已安装的依赖执行任意生命周期脚本，例如 postinstall。这些脚本代表潜在的安全风险，因为它们可以在你的机器上执行任意代码。要告诉 Bun 允许特定包的生命周期脚本，请将该包添加到 package.json 的 trustedDependencies 中。

package.json

{
  "name": "my-app",
  "version": "1.0.0",
  "trustedDependencies": ["my-trusted-package"] 
}

Bun 会读取此字段并为 my-trusted-package 运行生命周期脚本。

Git 依赖

从公共或私有 git 仓库添加依赖：

terminal

bun add git@github.com:moment/moment.git

要安装私有仓库，你的系统需要具有适当的 SSH 凭证才能访问该仓库。

Bun 支持多种协议，包括 github、git、git+ssh 和 git+https。

package.json

{
  "dependencies": {
    "dayjs": "git+https://github.com/iamkun/dayjs.git",
    "lodash": "git+ssh://github.com/lodash/lodash.git#4.17.21",
    "moment": "git@github.com:moment/moment.git",
    "zod": "github:colinhacks/zod"
  }
}

Tarball 依赖

包名称可以对应一个公开托管的 .tgz 文件。Bun 从该 tarball URL 下载并安装包，而不是从包注册表。

terminal

bun add zod@https://registry.npmjs.org/zod/-/zod-3.21.4.tgz

bun add 将 URL 写入你的 package.json：

package.json

{
  "dependencies": {
    "zod": "https://registry.npmjs.org/zod/-/zod-3.21.4.tgz"
  }
}

CLI 用法

bun add <package> <@version>

依赖管理

--production

boolean

不安装 devDependencies。别名：-p

--omit

string

从安装中排除 dev、optional 或 peer 依赖

--global

boolean

全局安装。别名：-g

--dev

boolean

添加到 devDependencies。别名：-d

--optional

boolean

添加到 optionalDependencies

--peer

boolean

添加到 peerDependencies

--exact

boolean

添加精确版本而非 ^ 范围。别名：-E

--only-missing

boolean

仅当依赖尚不存在时才添加到 package.json

项目文件与 Lockfile

--yarn

boolean

写入 yarn.lock 文件（yarn v1）。别名：-y

--no-save

boolean

不更新 package.json 或不保存 lockfile

--save

boolean

default:"true"

保存到 package.json

--frozen-lockfile

boolean

禁止更改 lockfile

--trust

boolean

添加到项目 package.json 的 trustedDependencies 中并安装该包

--save-text-lockfile

boolean

保存基于文本的 lockfile

--lockfile-only

boolean

仅生成 lockfile，不安装依赖

安装控制

--dry-run

boolean

不实际安装任何内容

--force

boolean

始终从注册表请求最新版本并重新安装所有依赖。别名：-f

--no-verify

boolean

跳过验证新下载包的完整性

--ignore-scripts

boolean

跳过项目 package.json 中的生命周期脚本（依赖的脚本从不运行）

--analyze

boolean

递归分析和安装作为参数传入的文件的依赖（使用 Bun 的打包器）。别名：-a

网络与注册表

--ca

string

提供证书颁发机构签名证书

--cafile

string

与 —ca 相同，但指定证书的文件路径

--registry

string

使用特定注册表，覆盖 .npmrc、bunfig.toml 和环境变量

--network-concurrency

number

default:"48"

最大并发网络请求数

性能与资源

--backend

string

default:"clonefile"

安装依赖的特定平台优化。可选：clonefile、hardlink、symlink 或 copyfile

--concurrent-scripts

number

生命周期脚本的最大并发作业数（默认：2 倍 CPU 核心数）

缓存

--cache-dir

string

从特定目录路径存储和加载缓存数据

--no-cache

boolean

完全忽略清单缓存

输出与日志

--silent

boolean

不输出任何日志

--verbose

boolean

极度详细的日志输出

--no-progress

boolean

禁用进度条

--no-summary

boolean

不打印摘要

全局配置与上下文

--config

string

指定配置文件路径（bunfig.toml）。别名：-c

--cwd

string

设置特定的当前工作目录

帮助

--help

boolean

打印此帮助菜单。别名：-h

核心命令

发布与分析

工作空间管理

高级配置

`--dev`

`--optional`

`--peer`

`--exact`

`--global`

可信依赖

Git 依赖

Tarball 依赖

CLI 用法

依赖管理

项目文件与 Lockfile

安装控制

网络与注册表

性能与资源

缓存

输出与日志

全局配置与上下文

帮助

​--dev

​--optional

​--peer

​--exact

​--global

​可信依赖

​Git 依赖

​Tarball 依赖

​CLI 用法

​依赖管理

​项目文件与 Lockfile

​安装控制

​网络与注册表

​性能与资源

​缓存

​输出与日志

​全局配置与上下文

​帮助

`--dev`

`--optional`

`--peer`

`--exact`

`--global`

可信依赖

Git 依赖

Tarball 依赖

CLI 用法

依赖管理

项目文件与 Lockfile

安装控制

网络与注册表

性能与资源

缓存

输出与日志

全局配置与上下文

帮助