前言

在 package.json 中，overrides 是一個(gè)非常強(qiáng)大的功能，主要用于強(qiáng)制覆蓋項(xiàng)目依賴樹中某些包的版本。

簡單來說，當(dāng)你遇到“依賴沖突”（比如 A 組件需要 React 17，B 組件需要 React 18）或者需要修復(fù)某個(gè)深層嵌套的子依賴漏洞時(shí)，overrides 可以幫你強(qiáng)制統(tǒng)一版本。

需要注意的是，不同的包管理工具（npm、pnpm、Yarn）對 overrides 的支持和寫法略有不同。以下我為你詳細(xì)梳理了它的核心用法、語法格式以及注意事項(xiàng)。

核心作用：解決什么問題？

1. 解決依賴沖突：強(qiáng)制將多個(gè)版本的同一個(gè)包統(tǒng)一為一個(gè)版本，減少 node_modules 體積并避免運(yùn)行時(shí)錯(cuò)誤。
2. 修復(fù)安全漏洞：當(dāng)某個(gè)深層的子依賴（例如 lodash 或 axios 的某個(gè)舊版本）存在安全漏洞時(shí)，強(qiáng)制將其升級到安全版本。
3. 強(qiáng)制升級/降級：在某些庫的最新版本有 Bug 時(shí)，強(qiáng)制鎖定到一個(gè)穩(wěn)定的舊版本。
4. 替換包源：強(qiáng)制將某個(gè)包替換為你自己的 Fork 版本或內(nèi)網(wǎng)版本。

語法格式詳解

overrides 的語法支持嵌套寫法和路徑寫法，這兩種寫法在 npm 和 pnpm 中通常都支持。

1. 基礎(chǔ)寫法（對象嵌套）

這種寫法層級清晰，適合覆蓋特定依賴下的子依賴。

{
  "overrides": {
    "react": "18.2.0", // 全局覆蓋：強(qiáng)制所有 react 版本為 18.2.0
    "lodash": "4.17.21", // 全局覆蓋：修復(fù)安全漏洞
    "some-package": {
      "react": "17.0.0" // 嵌套覆蓋：僅強(qiáng)制 some-package 依賴的 react 為 17.0.0
    },
    "foo": {
      "bar": "2.0.0" // 嵌套覆蓋：僅強(qiáng)制 foo 依賴的 bar 子依賴為 2.0.0
    }
  }
}

2. 高級寫法（路徑與通配符）

這種寫法更靈活，支持通配符和更復(fù)雜的路徑匹配。

3. 特殊操作（僅 pnpm 支持）

如果你使用的是 pnpm，它的 pnpm.overrides 功能最為強(qiáng)大，支持一些特殊操作：

• 刪除依賴：使用 - 可以刪除某個(gè)不需要的子依賴（例如刪除不必要的日志包）。

  {
    "pnpm": {
      "overrides": {
        "lodash>request": "-" 
      }
    }
  }
  

• 引用頂層版本：使用 $ 符號，讓子依賴去引用項(xiàng)目頂層安裝的版本，而不是自己安裝一份。

不同包管理工具的配置差異

為了防止配置后不生效，請務(wù)必確認(rèn)你使用的包管理器，并參考下表進(jìn)行配置：

示例：pnpm 的配置方式

{
  "name": "my-project",
  "version": "1.0.0",
  "pnpm": {
    "overrides": {
      "webpack": "5.75.0",
      "react-dom": "18.2.0"
    }
  }
}

注意事項(xiàng)與最佳實(shí)踐

雖然 overrides 很好用，但我也建議你謹(jǐn)慎使用：

1. 兼容性風(fēng)險(xiǎn)：強(qiáng)制覆蓋版本可能會(huì)導(dǎo)致依賴該包的其他庫無法正常工作（例如強(qiáng)行給一個(gè)需要 React 18 的組件塞入 React 17，可能會(huì)報(bào)錯(cuò)）。修改后務(wù)必進(jìn)行充分測試。
2. 版本范圍：你可以使用版本范圍（如 ^18.0.0 或 >=18），但為了穩(wěn)定性，建議在解決沖突時(shí)直接指定具體的版本號。
3. 清理緩存：如果配置了 overrides 但發(fā)現(xiàn)沒生效，通常是因?yàn)榕f的依賴緩存還在。建議刪除 node_modules 和鎖文件（package-lock.json 或 pnpm-lock.yaml），然后重新執(zhí)行 npm install 或 pnpm install。
4. 優(yōu)先級：overrides 的優(yōu)先級高于 dependencies 和 devDependencies。

總結(jié)

到此這篇關(guān)于package.json中overrides用法的文章就介紹到這了,更多相關(guān)package.json中overrides用法內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論