使用 fnm 安裝 Node.js
fnm 讓安裝和管理 Node.js 版本變得簡單快捷。本指南將詳細介紹如何使用 fnm 安裝 Node.js。
快速開始
安裝最新 LTS 版本
bash
fnm install --lts安裝最新版本
bash
fnm install --latest安裝指定版本
bash
fnm install 20
fnm install 18.17.0安裝方式詳解
安裝 LTS 版本
Node.js LTS（長期支持）版本推薦用於生產環境：
bash
# 安裝最新 LTS 版本
fnm install --lts
# 安裝指定 LTS 版本
fnm install lts/iron # Node.js 20.x
fnm install lts/hydrogen # Node.js 18.x
fnm install lts/gallium # Node.js 16.xLTS 版本代號對照表：
| 代號 | 版本 | 狀態 |
|---|---|---|
| Iron | 20.x | Active LTS |
| Hydrogen | 18.x | Maintenance |
| Gallium | 16.x | End of Life |
安裝特定版本
bash
# 安裝主版本（自動選擇最新的次版本）
fnm install 20
# 安裝特定版本
fnm install 20.10.0
# 安裝舊版本
fnm install 14.21.3使用版本文件安裝
在項目目錄中創建 .node-version 或 .nvmrc 文件：
bash
# 創建 .node-version 文件
echo "20" > .node-version
# fnm 會自動讀取並安裝
fnm install安裝後使用
切換到已安裝版本
bash
# 使用指定版本
fnm use 20
# 如果版本未安裝，自動安裝後使用
fnm use 18 --install-if-missing設置默認版本
bash
# 設置默認版本
fnm default 20
# 查看當前默認版本
fnm default安裝後立即使用
bash
# 安裝並立即切換到該版本
fnm install 20 --use查看可用版本
查看遠程版本
bash
# 列出所有可用版本
fnm list-remote
# 只列出 LTS 版本
fnm list-remote --lts
# 過濾特定版本
fnm list-remote --filter=18
# 查看最新版本
fnm list-remote --latest查看本地已安裝版本
bash
fnm list輸出示例：
* v20.10.0 default
v18.19.0
v16.20.2使用鏡像加速
在中國大陸，可以使用鏡像加速下載：
bash
# 設置鏡像環境變量
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node
# 或者在安裝時指定
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node常用鏡像：
| 鏡像源 | 地址 |
|---|---|
| npmmirror | https://npmmirror.com/mirrors/node |
| 清華大學 | https://mirrors.tuna.tsinghua.edu.cn/nodejs-release |
Corepack 支持
fnm 支持 Corepack，可以自動啟用 Yarn 和 pnpm：
bash
# 安裝時啟用 Corepack
fnm install 20 --corepack-enabled
# 或設置環境變量
export FNM_COREPACK_ENABLED=true
fnm install 20版本管理最佳實踐
項目級版本管理
在項目根目錄創建 .node-version 文件：
bash
# 指定主版本
echo "20" > .node-version
# 或指定精確版本
echo "20.10.0" > .node-version配合 --use-on-cd 選項，進入目錄時自動切換版本：
bash
# 在 Shell 配置中添加
eval "$(fnm env --use-on-cd)"多版本開發
bash
# 安裝多個版本
fnm install 20
fnm install 18
fnm install 16
# 在不同項目間切換
cd project-a && fnm use 20
cd project-b && fnm use 18使用別名
bash
# 設置別名
fnm alias 20 default
fnm alias 18 legacy
# 使用別名切換
fnm use default
fnm use legacy常見問題
安裝失敗
如果安裝失敗，請檢查：
- 網絡連接是否正常
- 是否需要配置鏡像
- 磁盤空間是否充足
bash
# 使用鏡像重試
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node版本切換不生效
確保已正確配置 Shell：
bash
# 檢查當前版本
fnm current
# 檢查 node 路徑
which node清理舊版本
bash
# 查看已安裝版本
fnm list
# 卸載不需要的版本
fnm uninstall 16.20.2