Skip to main content
要升级 Bun CLI 版本，请参阅 bun upgrade。
要将所有依赖项更新到最新版本：
terminal
bun update
要将特定依赖项更新到最新版本：
terminal
bun update [package]

​
--interactive

为了获得更可控的更新体验，使用 --interactive 标志选择要更新的包：
terminal
bun update --interactive
bun update -i
这将启动一个交互式终端界面，显示所有过期的包及其当前版本和目标版本。然后你可以选择要更新的包。

​
交互界面

界面显示按依赖类型分组的包： 
? Select packages to update - Space to toggle, Enter to confirm, a to select all, n to select none, i to invert, l to toggle latest

  dependencies                Current  Target   Latest
    □ react                   17.0.2   18.2.0   18.3.1
    □ lodash                  4.17.20  4.17.21  4.17.21

  devDependencies             Current  Target   Latest
    □ typescript              4.8.0    5.0.0    5.3.3
    □ @types/node             16.11.7  18.0.0   20.11.5

  optionalDependencies        Current  Target   Latest
    □ some-optional-package   1.0.0    1.1.0    1.2.0
分组说明：
  • 包按节标题分组：dependencies、devDependencies、peerDependencies、optionalDependencies
  • 每组显示与包数据对齐的列标题
列说明：
  • Package（包名）：包的名称（可能会有 dev、 peer、 optional 等后缀以区分）
  • Current（当前）：当前安装的版本
  • Target（目标）：将要安装的版本（符合 semver 约束）
  • Latest（最新）：最新可用的版本

​
键盘操作

选择操作：
  • 空格：切换包的选择状态
  • 回车：确认选择并更新
  • a/A：全选所有包
  • n/N：全不选
  • i/I：反选
导航操作：
  • ↑/↓ 方向键 或 j/k：移动光标
  • l/L：切换当前包的目标版本和最新版本显示
退出：
  • Ctrl+C 或 Ctrl+D：取消且不更新

​
视觉指示

  • ☑ 已选择的包（将被更新）
  • □ 未选中的包
  • > 当前光标所在位置
  • 颜色：红色表示大版本更新，黄色表示小版本更新，绿色表示补丁更新
  • 下划线：当前选中的更新目标版本

​
包分组

包根据依赖类型组织分组：
  • dependencies - 常规运行时依赖
  • devDependencies - 开发依赖
  • peerDependencies - 同级依赖
  • optionalDependencies - 可选依赖
每个分组内，个别包可能带有额外后缀（ dev、 peer、 optional）以增加区分度。

​
--recursive

配合 --interactive 使用 --recursive 标志可以在 monorepo 的所有工作区内更新依赖：
terminal
bun update --interactive --recursive
bun update -i -r
该命令会额外显示一个 “Workspace” 列，显示每个依赖所属的工作区。

​
--latest

默认情况下，bun update 会更新到符合 package.json 中版本范围的最新依赖版本。 如果想更新到不受当前版本范围限制的最新版本，可以使用 --latest 标志：
terminal
bun update --latest
在交互模式下，可以使用 l 键切换单个包的目标版本（遵守 semver）和最新版本。 例如，以下 package.json：
package.json
{
  "dependencies": {
    "react": "^17.0.2"
  }
}
  • bun update 会升级到匹配 17.x 的版本。
  • bun update --latest 会升级到匹配 18.x 或更高版本。

​
CLI 用法

terminal
bun update <package> <version>

​
更新策略

​
--force
boolean
始终从注册表请求最新版本并重新安装所有依赖。别名: -f
​
--latest
boolean
将包更新到最新版本

​
依赖范围

​
--production
boolean
不安装 devDependencies。别名: -p
​
--global
boolean
全局安装。别名: -g
​
--omit
string
从安装中排除 dev、optional 或 peer 依赖

​
项目文件管理

​
--yarn
boolean
写入 yarn.lock 文件（yarn v1）。别名: -y
​
--no-save
boolean
不更新 package.json 或保存锁文件
​
--save
boolean
default:"true"
保存到 package.json（默认启用）
​
--frozen-lockfile
boolean
禁止修改锁文件
​
--save-text-lockfile
boolean
保存基于文本的锁文件
​
--lockfile-only
boolean
仅生成锁文件，不安装依赖

​
网络与注册表

​
--ca
string
提供证书颁发机构（CA）签发证书
​
--cafile
string
与 —ca 相同，但作为证书的文件路径
​
--registry
string
默认使用指定注册表，覆盖 .npmrc、bunfig.toml 和环境变量设置
​
--network-concurrency
number
default:"48"
最大并发网络请求数（默认 48）

​
缓存

​
--cache-dir
string
从指定目录路径存储及加载缓存数据
​
--no-cache
boolean
完全忽略清单缓存

​
输出与日志

​
--silent
boolean
不输出任何日志
​
--verbose
boolean
过度详细的日志输出
​
--no-progress
boolean
禁用进度条
​
--no-summary
boolean
不打印摘要信息

​
脚本执行

​
--ignore-scripts
boolean
跳过项目 package.json 中的生命周期脚本（依赖脚本永远不会执行）
​
--concurrent-scripts
number
default:"5"
生命周期脚本的最大并发作业数（默认 5）

​
安装控制

​
--no-verify
boolean
跳过校验新下载包的完整性
​
--trust
boolean
添加到项目 package.json 的 trustedDependencies 并安装包
​
--backend
string
default:"clonefile"
安装依赖的特定平台优化。可选值：clonefile（默认）、hardlink、symlink、copyfile

​
常规与环境

​
--config
string
指定配置文件路径（bunfig.toml）。别名: -c
​
--dry-run
boolean
不安装任何内容
​
--cwd
string
设置特定的当前工作目录
​
--help
boolean
打印此帮助菜单。别名: -h