bun publish

使用 bun publish 将包发布到 npm 注册表

bun publish 将自动将你的包打包成一个 tarball，从 [package.json] 中剥离目录和工作区协议（必要时解析版本），并发布到你在配置文件中指定的注册表。支持 [bunfig.toml] 和 [.npmrc] 文件。

terminal

## 从当前工作目录发布包
bun publish

bun publish v1.3.3 (ca7428e9)

packed 203B package.json
packed 224B README.md
packed 30B index.ts
packed 0.64KB tsconfig.json

Total files: 4
Shasum: 79e2b4377b63f4de38dc7ea6e5e9dbee08311a69
Integrity: sha512-6QSNlDdSwyG/+[...]X6wXHriDWr6fA==
Unpacked size: 1.1KB
Packed size: 0.76KB
Tag: latest
Access: default
Registry: http://localhost:4873/

 + publish-1@1.0.0

或者，你可以通过使用 bun pm pack 然后使用 bun publish 配合输出 tarball 的路径来分别打包和发布你的包。

terminal

bun pm pack
...
bun publish ./package.tgz

如果提供了 tarball 路径，bun publish 将不会运行生命周期脚本（prepublishOnly/prepack/prepare/postpack/publish/postpublish）。只有当包是由 bun publish 打包时才会运行脚本。

--access

--access 标志可用于设置正在发布的包的访问级别。访问级别可以是 public 或 restricted 之一。未作用域的包始终是公共的，尝试使用 --access restricted 发布未作用域的包将导致错误。

terminal

bun publish --access public

--access 也可以在你的 [package.json] 的 [publishConfig]字段中设置。

package.json

{
  "publishConfig": {
    "access": "restricted"
  }
}

--tag

设置正在发布的包版本的标签。默认情况下，标签是 latest。包的初始版本除了指定的标签外，还会始终获得 latest 标签。

terminal

bun publish --tag alpha

--tag 也可以在你的 [package.json] 的 [publishConfig] 字段中设置。

package.json

{
  "publishConfig": {
    "tag": "next"
  }
}

--dry-run

--dry-run 标志可用于模拟发布过程而不实际发布包。这对于在不实际发布包的情况下验证已发布包的内容很有用。

terminal

bun publish --dry-run

--tolerate-republish

如果包版本已存在，则以代码 0 而不是 1 退出。在可能重新运行作业的 CI/CD 中很有用。

terminal

bun publish --tolerate-republish

--gzip-level

指定打包包时使用的 gzip 压缩级别。仅适用于没有 tarball 路径参数的 bun publish。值范围为 0 到 9（默认为 9）。

--auth-type

如果您的 npm 账户启用了两因素认证，bun publish 将提示您输入一次性密码。这可以通过浏览器或 CLI 完成。--auth-type 标志可用于告知 npm 注册表您首选的方法。可能的值是 web 和 legacy，默认为 web。

terminal

bun publish --auth-type legacy
...
This operation requires a one-time password.
Enter OTP: 123456
...

--otp

直接向 CLI 提供一次性密码。如果密码有效，这将在发布前跳过额外的一次性密码提示。使用示例：

terminal

bun publish --otp 123456

bun publish 尊重 NPM_CONFIG_TOKEN 环境变量，该变量可以在 github actions 或自动化工作流中发布时使用。

---

CLI 用法

terminal

bun publish dist

发布选项

--access · string

--access 标志可用于设置正在发布的包的访问级别。访问级别可以是 public 或 restricted 之一。无作用域的包始终是公共的，尝试使用 --access restricted 发布无作用域的包将导致错误。

terminal

bun publish --access public

--access 也可以在 package.json 的 publishConfig 字段中设置。

package.json

{
  "publishConfig": {
    "access": "restricted"
  }
}

--tag · string · default: "latest"

设置正在发布的包版本的标签。默认情况下，标签是 latest。包的初始版本除了指定的标签外，总是被赋予 latest 标签。

terminal

bun publish --tag alpha

--tag 也可以在 package.json 的 publishConfig 字段中设置。

package.json

{
  "publishConfig": {
    "tag": "next"
  }
}

--dry-run=<val> · string

--dry-run 标志可用于模拟发布过程而不实际发布包。这对于在不实际发布包的情况下验证发布包的内容很有用。

bun publish --dry-run

--gzip-level · string · default: "9"

指定打包包时使用的 gzip 压缩级别。仅适用于没有 tarball 路径参数的 bun publish 值的范围是 0 到 9（默认值为 9）。

--auth-type · string · default: "web"

如果您的 npm 账户启用了两步验证，bun publish 将提示您输入一次性密码。这可以通过浏览器或 CLI 完成。--auth-type 标志可用于告诉 npm 注册表您偏好的方法。可能的值是 web 和 legacy，默认值是 web。

terminal

bun publish --auth-type legacy
...
此操作需要一次性密码。
输入 OTP: 123456
...

--otp · string · default: "web"

直接向 CLI 提供一次性密码。如果密码有效，这将在发布前跳过额外的一次性密码提示。示例用法：

terminal

bun publish --otp 123456

bun publish 尊重 NPM_CONFIG_TOKEN 环境变量，该变量可以在 github actions 或自动化工作流中发布时使用。

注册表配置

自定义注册表

--registry · string

指定注册表 URL，覆盖 .npmrc 和 bunfig.toml

bun publish --registry https://my-private-registry.com

SSL 证书

--ca · string

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

--cafile · string

证书颁发机构证书文件的路径

内联证书

bun publish --ca "-----BEGIN CERTIFICATE-----..."

发布选项

依赖管理

-p, --production · boolean

不安装 devDependencies

--omit · string

排除依赖类型：dev、optional 或 peer

-f, --force · boolean

始终从注册表请求最新版本并重新安装所有依赖

脚本控制

--ignore-scripts · boolean

在打包和发布期间跳过生命周期脚本

--trust · boolean

将包添加到 trustedDependencies 并运行它们的脚本

生命周期脚本 — 提供预构建的 tarball 时，不会执行生命周期脚本（prepublishOnly、prepack 等）。 只有当 Bun 自己打包包时才运行脚本。

文件管理

--no-save · boolean

不更新 package.json 或锁文件

--frozen-lockfile · boolean

禁止更改锁文件

--yarn · boolean

生成 yarn.lock 文件（与 yarn v1 兼容）

性能

--backend · string

平台优化：clonefile（默认）、hardlink、symlink 或 copyfile

--network-concurrency · number · default: "48"

最大并发网络请求

--concurrent-scripts · number · default: "5"

最大并发生命周期脚本

输出控制

--silent · boolean

抑制所有输出

--verbose · boolean

显示详细日志

--no-progress · boolean

隐藏进度条

--no-summary · boolean

不打印发布摘要