bunx 使用文档

liangshanbo1215

已于 2024-03-07 09:52:08 修改

阅读量1k

点赞数 17

分类专栏： Bun 文章标签：前端 node.js

于 2024-03-07 09:51:53 首次发布

本文链接：https://blog.csdn.net/liangshanbo1215/article/details/136524548

版权

14 篇文章

订阅专栏

本文介绍了Bunx，一个类似npx的包管理器，它能快速安装并运行本地包，速度比npx快100倍。文章详细讲解了如何在package.json中定义可执行文件、shebang的使用以及如何传递命令行参数给可执行文件。Bunx还支持与Node.js运行时的灵活交互。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

注意 — bunx 是 bun x 的别名。安装 bun 时，bunx CLI 将自动安装。

使用 bunx 从 npm 自动安装和运行包。它相当于 npx 或 yarn dlx。

bunx cowsay "Hello world!"

⚡️ 速度 — 由于 Bun 的启动时间很快，对于本地安装的软件包，bunx 大约比 npx 快 100 倍。

软件包可以在其package.json的"bin"字段中声明可执行文件。这些文件称为包可执行文件或包二进制文件。

// package.json

{
  // ... other fields
  "name": "my-cli",
  "bin": {
    "my-cli": "dist/index.js"
  }
}

这些可执行文件通常是纯 JavaScript 文件，标有 shebang 行，以指示应该使用哪个程序来执行它们。以下文件指示它应该与 node 一起执行。

#!/usr/bin/env node

console.log("Hello world!");

这些可执行文件可以用 bunx 运行。

bunx my-cli

与 npx 一样，bunx 将首先检查本地安装的包，然后回退到从 npm 自动安装包。已安装的软件包将存储在 Bun 的全局缓存中，以备将来使用。

若要将其他命令行标志和参数传递到可执行文件，请将它们放在可执行文件名称之后。

bunx my-cli --foo bar

默认情况下，Bun 尊重 shebangs。如果可执行文件标记为 #!/usr/bin/env node 将启动一个node进程来执行该文件。但是，在某些情况下，可能需要使用 Bun 的运行时运行可执行文件，即使可执行文件另有指示。为此，请包含 --bun 标志。

bunx --bun my-cli

--bun 标志必须出现在可执行文件名称之前。名称后显示的标志将传递到可执行文件。

bunx --bun my-cli # good
bunx my-cli --bun # bad

要强制 bun 始终与脚本一起使用，请使用 shebang。

#!/usr/bin/env bun