在本地目录中使用 bun link 来注册当前包为“可链接”包。

terminal

cd /path/to/cool-pkg
cat package.json
bun link

Text

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" // [!code ++]
  }
}

取消链接

在包的根目录使用 bun unlink 来注销本地包。

terminal

cd /path/to/cool-pkg
bun unlink

Text

bun unlink v1.3.3 (7416672e)
success: unlinked package "cool-pkg"

CLI 使用方法

bash

bun link <packages>

安装范围

--globalboolean

全局安装。别名：-g

依赖管理

--productionboolean

不安装 devDependencies。别名：-p

--omitstring

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

项目文件及锁文件

--yarnboolean

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

--frozen-lockfileboolean

禁止更改锁文件

--save-text-lockfileboolean

保存文本格式的锁文件

--lockfile-onlyboolean

仅生成锁文件，不安装依赖

--no-saveboolean

无效果。bun link 仅在使用 --save 时更新 package.json 和锁文件

--saveboolean

保存到 package.json

--trustboolean

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

安装控制

--forceboolean

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

--no-verifyboolean

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

--backendstring

安装依赖时使用的平台特定优化方式。可选值为 clonefile、hardlink、symlink 或 copyfile

--linkerstring

链接策略（可选 isolated 或 hoisted）

--dry-runboolean

使用 bun link <package> 时，仅解析包，不安装包、不更新 package.json，也不保存锁文件。对不带参数的 bun link 无效；该命令仍会注册当前包

--ignore-scriptsboolean

跳过所有包的生命周期脚本，包括项目的 package.json 和受信任的依赖项

网络与注册表

--castring

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

--cafilestring

同 --ca，但是为证书的文件路径

--registrystring

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

--network-concurrencynumberdefault 48

最大并发网络请求数

性能与资源

--concurrent-scriptsnumber

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

缓存

--cache-dirstring

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

--no-cacheboolean

完全忽略清单缓存

输出与日志

--silentboolean

不输出任何日志

--quietboolean

禁用进度条

--verboseboolean

超级详细的日志输出

--no-progressboolean

禁用进度条

--no-summaryboolean

不打印总结信息

平台目标

--cpustring

为可选依赖覆盖 CPU 架构（例如，x64、arm64、* 表示全部）

--osstring

为可选依赖覆盖操作系统（例如，linux、darwin、* 表示全部）

全局配置与上下文

--configstring

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

--cwdstring

设置特定的当前工作目录

帮助

--helpboolean

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