📦 從入門到精通：npm install + 套件版本管理完全指南
Copyright Notice: This article is an original work licensed under the CC 4.0 BY-NC-ND license.
If you wish to repost this article, please include the original source link and this copyright notice.
Source link: https://v2know.com/article/1176
真正完整的 npm install 相關教學，就不能只談安裝，還要包括：
-
升級與回退
-
解除安裝 (
uninstall) -
查看版本、依賴、更新可用性
-
還原、清空、鎖定等操作
以下是 最完整的 npm install + 套件管理操作指南 （進階實用向）：
📦 從入門到精通：npm install + 套件版本管理完全指南
這不只是教你怎麼用
npm install裝套件，我們將一起深入探索包括解除安裝、版本升級與回退、鎖定與還原等一系列實用操作，真正掌握 npm 套件管理的核心技能。
🚀 一、基本安裝：npm install
✅ 安裝單一套件
npm install lodash
將安裝最新版的 lodash 並寫入 dependencies。
✅ 安裝特定版本
npm install [email protected]
完全指定版本，不會升級。
✅ 加入 devDependencies（開發用）
npm install typescript --save-dev
寫入 devDependencies 區段。
✅ 全域安裝（CLI 用）
npm install -g typescript
全域安裝後，可直接使用 tsc 指令。
🔄 二、升級、回退與切換版本
🔼 更新套件到最新版本
npm update lodash
但僅限於 package.json 範圍內（如 ^4.17.0 只能升到 4.x.x）。
⬇️ 回退套件版本
npm install [email protected]
強制回退，並更新 package.json 與 package-lock.json。
❌ 三、解除安裝：npm uninstall
🧹 移除套件
npm uninstall lodash
會從：
-
node_modules中刪除套件 -
package.json的dependencies中移除 -
package-lock.json中清除紀錄
🔧 移除 devDependencies
npm uninstall typescript
會自動偵測並從 devDependencies 刪除。
🔍 四、查看套件與版本
📦 查看已安裝的版本
npm list lodash
或查看全域版本：
npm list -g typescript
🆕 檢查有無新版本
npm outdated
會顯示：
| 套件 | 安裝版本 | 想要版本 | 最新版本 |
|---|
🧠 查詢套件資訊
npm info lodash
會列出版本、維護者、license、描述、下載量等等。
📌 五、還原與鎖定環境
🔒 鎖定精確版本
避免自動升級，把 ^ 移除，例如：
"lodash": "4.17.15"
或直接手動寫入精確版本。
♻️ 重新還原依賴
npm ci
與
npm install類似，但會嚴格根據package-lock.json還原，不會自動修改任何東西，CI/CD 或部署環境必用！
🧹 刪除並重建所有套件
rm -rf node_modules package-lock.json
npm install
完全重裝，適合「環境亂了」時重建。
🔧 六、進階使用技巧與最佳實踐
| 操作 | 指令 |
|---|---|
只安裝 devDependencies |
npm install --only=dev |
| 安裝但不寫入 package.json | npm install lodash --no-save |
| 查看所有依賴結構 | npm ls |
| 檢查安全漏洞 | npm audit |
🎮 當我們用 Chrono Divide 套件時會發生？
以 @chronodivide/game-api 為例：
npm install @chronodivide/game-api
會：
-
安裝到
node_modules/@chronodivide/game-api -
在
package.json記錄為^1.2.3 -
在
package-lock.json鎖住實際下載版本 -
可在程式中使用：
import { GameApi } from '@chronodivide/game-api';
如果有新版，你可以：
npm update @chronodivide/game-api
如想指定回退版本：
npm install @chronodivide/[email protected]
✅ 小結
| 功能 | 指令 |
|---|---|
| 安裝套件 | npm install <pkg> |
| 安裝指定版本 | npm install <pkg>@1.2.3 |
| 解除安裝 | npm uninstall <pkg> |
| 檢查可更新版本 | npm outdated |
| 升級套件 | npm update <pkg> |
| 回退版本 | npm install <pkg>@舊版本 |
| 重建環境 | rm -rf node_modules && npm install |
| 精準還原 | npm ci |
想讓你的 Node.js 專案穩定又易於維護，掌握這些 npm 套件管理技巧絕對必備。希望這篇教學對你有幫助，歡迎收藏、分享或留言交流！
→返回目錄
This article was last edited at