執行環境套件管理器打包器測試執行器程式碼檢查格式化指南參考部落格意見回饋

bun link

連結本地包以便開發

在本地目錄中使用 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