bun add

新增特定套件

bun add preact

指定版本、版本範圍或標籤

bun add zod@3.20.0

bun add zod@^3.0.0

bun add zod@latest

--dev

將套件新增為開發相依性 ("devDependencies")

bun add --dev @types/react

bun add -d @types/react

--optional

將套件新增為選用相依性 ("optionalDependencies")

bun add --optional lodash

--peer

將套件新增為同儕相依性 ("peerDependencies")

bun add --peer @types/bun

--exact

若要新增套件並鎖定已解析的版本，請使用 --exact。這會解析套件的版本，並將其新增到您的 package.json，使用精確的版本號碼而非版本範圍。

bun add react --exact

bun add react -E

這會將以下內容新增到您的 package.json

{
  "dependencies": {
    // without --exact
    "react": "^18.2.0", // this matches >= 18.2.0 < 19.0.0

    // with --exact
    "react": "18.2.0" // this matches only 18.2.0 exactly
  }
}

若要檢視此命令的完整選項列表

bun add --help

--global

若要全域安裝套件，請使用 -g/--global 旗標。這不會修改您目前專案的 package.json。通常用於安裝命令列工具。

bun add --global cowsay # or `bun add -g cowsay`

cowsay "Bun!"

 ______
< Bun! >
 ------
        \   ^__^
         \  (oo)\_______
            (__)\       )\/\
                ||----w |
                ||     ||

[install]
# where `bun add --global` installs packages
globalDir = "~/.bun/install/global"

# where globally-installed package bins are linked
globalBinDir = "~/.bun/bin"

受信任的相依性

與其他 npm 用戶端不同，Bun 不會為已安裝的相依性執行任意生命週期腳本，例如 postinstall。這些腳本代表潛在的安全風險，因為它們可能會在您的機器上執行任意程式碼。

若要告知 Bun 允許特定套件的生命週期腳本，請將該套件新增至您 package.json 中的 trustedDependencies。

{
  "name": "my-app",
  "version": "1.0.0",
  "trustedDependencies": ["my-trusted-package"]
}

Bun 會讀取此欄位，並為 my-trusted-package 執行生命週期腳本。

Git 相依性

從公開或私有 git 儲存庫新增相依性

bun add git@github.com:moment/moment.git

Bun 支援多種協定，包括 github、 git、 git+ssh、 git+https 和更多協定。

{
  "dependencies": {
    "dayjs": "git+https://github.com/iamkun/dayjs.git",
    "lodash": "git+ssh://github.com/lodash/lodash.git#4.17.21",
    "moment": "git@github.com:moment/moment.git",
    "zod": "github:colinhacks/zod"
  }
}

Tarball 相依性

套件名稱可以對應到公開託管的 .tgz 檔案。在安裝期間，Bun 將從指定的 tarball URL 下載並安裝套件，而不是從套件登錄檔。

bun add zod@https://registry.npmjs.org/zod/-/zod-3.21.4.tgz

這會將以下行新增到您的 package.json

{
  "dependencies": {
    "zod": "https://registry.npmjs.org/zod/-/zod-3.21.4.tgz"
  }
}