了解版本控制在 NPM package.json 中的工作原理-js教程-PHP中文網

Know How Versioning Works in NPM package.json

了解 NPM 版本控制：綜合指南

管理相依性是任何現代開發工作流程的重要組成部分，尤其是在基於 JavaScript 的專案中。 NPM（節點套件管理器）簡化了這個過程，但了解其版本控制系統是維護應用程式穩定和安全的關鍵。

在本部落格中，我們將深入研究 NPM 版本控制，解釋其語法、最佳實踐和實際應用程式。最後，您將能夠自信地管理專案中的依賴項。

什麼是 NPM 版本控制？

NPM 版本控制是基於 語意版本控制 (SemVer)，這是一個旨在傳達有關套件中底層變更的含義的系統。

語意版本格式

NPM 中的版本號碼遵循以下格式：

主要.次要.補丁

主要：引入重大變更。
次要：新增功能而不破壞現有功能。
PATCH：修正錯誤或進行向後相容更新。

例子

1.4.2

1：主要版本（此處介紹的重大變更）。
4：次要版本（此處新增的功能）。
2：補丁版本（錯誤修復）。

版本控制的重要性

正確的版本管理有助於：

透過避免不相容的更新來確保穩定性。
促進團隊和開源社群內的協作。
透過套用修補程式來保護專案免受漏洞影響。

版本範圍在 NPM 中如何運作

在 package.json 中定義依賴項時，版本範圍決定了您的專案可以接受的套件版本。

通用版本範圍語法

確切版本
- 語法：“1.4.2”
- 僅安裝指定版本。
脫字 (^)
- 語法：“^1.4.2”
- 允許在同一主要版本內進行更新（例如，1.4.2 到 1.9.0，但不允許更新 2.0.0）。
波形符 (~)
- 語法：“~1.4.2”
- 允許在同一次要版本內進行更新（例如，1.4.2 到 1.4.9，但不允許更新 1.5.0）。
通配符 (*)
- 語法：“*”
- 接受任何版本，這是有風險的，通常不鼓勵。
範圍運算子
- 範例：“>=1.2.0
- 指定可接受的版本範圍。

實際例子

在 package.json 中設定依賴關係

以下是如何在專案中使用不同版本控制策略的方法：

{
  "dependencies": {
    "express": "^4.17.1", // Allows updates up to <5.0.0
    "lodash": "~4.17.21", // Allows updates up to <4.18.0
    "axios": "0.21.1" // Installs exactly this version
  }
}

登入後複製

結果：

快遞包將更新到4.x.x範圍內的任何相容版本。
lodash 將在 4.17.x 範圍內更新。
axios 將保持鎖定版本 0.21.1。

使用 npm install 命令

npm install 指令可讓您直接控製版本控制行為。

安裝特定版本

npm install lodash@4.17.20

登入後複製

結果：安裝 lodash 4.17.20 版本。

安裝最新的相容版本

npm install lodash@^4.17.0

登入後複製

結果：安裝 4.x.x 範圍內的最新版本。

了解 package-lock.json

package-lock.json 檔案透過鎖定安裝的確切版本來確保跨環境的依賴版本一致。

為什麼它很重要？

防止意外的版本不符。
提供依賴關係樹的快照。
透過將相依性鎖定到已知安全版本來提高安全性。

NPM 版本控制的最佳實踐

預設使用插入符 (^)
- 在主要版本中保持靈活性的同時保持穩定性。
避免通配符 (*)
- 通配符可能會導致專案發生重大變化。
定期更新
- 使用 npm outdated 等工具來辨識過時的依賴項。
利用版本控制工具
- npm-check-updates：自動將相依性升級到最新版本。
```
npm install -g npm-check-updates
ncu -u
npm install
```
登入後複製
更新後測
- 更新依賴項後始終徹底測試您的應用程式。

管理對等依賴性

當一個套件依賴您的專案也必須包含的另一個套件的特定版本時，將使用對等依賴關係。

例子

{
  "peerDependencies": {
    "react": "^17.0.0"
  }
}

登入後複製

行為：

NPM 不會自動安裝對等依賴項；您必須手動將它們新增至您的專案。

處理安全性更新

過時的依賴項可能會引入漏洞。使用以下步驟確保安全：

檢查漏洞
```
npm audit
```
登入後複製
自動修復問題
```
npm audit fix
```
登入後複製
監控依賴狀況
- 像Snyk這樣的工具可以提供對依賴漏洞的更深入的洞察。

要避免的常見陷阱

忽略補丁更新
- 即使是小修補程式也可以修復嚴重的錯誤或漏洞。
使用最新版本
- 這可能會導致生產中的相容性問題。
不檢查依賴項更新
- 自動更新有時會破壞功能。始終查看發行說明。

結論

NPM 版本控制由語義版本控制提供支持，是管理 JavaScript 專案中依賴項的基本技能。透過了解版本範圍、最佳實踐和工具，您可以建立更穩定、安全和可維護的應用程式。

重點

使用 ^ 在主要版本中獲得靈活性。
定期審核和更新依賴項。
利用 npm Audit 和 npm-check-updates 等工具來簡化版本管理。

透過這些實踐，您將最大限度地降低風險、改善協作並保持專案順利運作。

進一步閱讀

NPM 官方文件
語意版本控制規範
npm-check-updates GitHub

立即開始掌握 NPM 版本控制並轉變管理專案中依賴項的方式！

以上是了解版本控制在 NPM package.json 中的工作原理的詳細內容。更多資訊請關注PHP中文網其他相關文章！