bun link

链接本地包进行开发

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

terminal

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

bun link v1.3.3 (7416672e)
Success! Registered "cool-pkg"

To use cool-pkg in a project, run:
  bun link cool-pkg

Or add it in dependencies in your package.json file:
  "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（默认为 true）

--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

打包时仅显示 tarball 名称

--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