Skip to main content
在本地目录中使用 bun link 来注册当前包为“可链接”包。
terminal
cd /path/to/cool-pkg
cat package.json
bun link

bun link v1.3.3 (7416672e)
成功！已注册 "cool-pkg"

要在项目中使用 cool-pkg，请运行：
  bun link cool-pkg

或者在你的 package.json 文件的依赖中添加：
  "cool-pkg": "link:cool-pkg"
现在可以使用 bun link cool-pkg 将此包“链接”到其他项目中。这将在目标项目的 node_modules 目录中创建一个符号链接，指向本地目录。
terminal
cd /path/to/my-app
bun link cool-pkg
此外，可以使用 --save 标志将 cool-pkg 添加到你的应用的 package.json 的 dependencies 字段中，使用一个特殊的版本说明符，告诉 Bun 从已注册的本地目录加载，而不是从 npm 安装：
package.json
{
  "name": "my-app",
  "version": "1.0.0",
  "dependencies": {
    "cool-pkg": "link:cool-pkg"
  }
}

​
取消链接

在包的根目录使用 bun unlink 来注销本地包。
terminal
cd /path/to/cool-pkg
bun unlink

bun unlink v1.3.3 (7416672e)

​
CLI 使用方法

bun link <packages>

​
安装范围

​
--global
boolean
全局安装。别名：-g

​
依赖管理

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

​
项目文件及锁文件

​
--yarn
boolean
写入 yarn.lock 文件（yarn v1）。别名：-y
​
--frozen-lockfile
boolean
禁止更改锁文件
​
--save-text-lockfile
boolean
保存文本格式的锁文件
​
--lockfile-only
boolean
仅生成锁文件，不安装依赖
​
--no-save
boolean
不更新 package.json 或保存锁文件
​
--save
boolean
default:"true"
保存到 package.json（默认启用）
​
--trust
boolean
添加到项目 package.json 的 trustedDependencies 并安装该包

​
安装控制

​
--force
boolean
始终从注册表请求最新版本并重新安装所有依赖。别名：-f
​
--no-verify
boolean
跳过验证新下载包的完整性
​
--backend
string
default:"clonefile"
针对平台优化依赖安装。可选值：clonefile（默认）、hardlink、symlink、copyfile
​
--linker
string
链接策略（可选 isolated 或 hoisted）
​
--dry-run
boolean
不执行任何安装
​
--ignore-scripts
boolean
跳过项目 package.json 中的生命周期脚本（依赖的脚本永远不会运行）

​
网络与注册表

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

​
性能与资源

​
--concurrent-scripts
number
default:"5"
生命周期脚本最大并发作业数（默认 5）

​
缓存

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

​
输出与日志

​
--silent
boolean
不输出任何日志
​
--quiet
boolean
打包时只显示压缩包名称
​
--verbose
boolean
超级详细的日志输出
​
--no-progress
boolean
禁用进度条
​
--no-summary
boolean
不打印总结信息

​
平台目标

​
--cpu
string
为可选依赖覆盖 CPU 架构（例如，x64、arm64、* 表示全部）
​
--os
string
为可选依赖覆盖操作系统（例如，linux、darwin、* 表示全部）

​
全局配置与上下文

​
--config
string
指定配置文件路径（bunfig.toml）。别名：-c
​
--cwd
string
设置特定的当前工作目录

​
帮助

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