2025-03-20-什麼是 nvm

2025-03-20-什麼是 nvm

你目前的系統找不到 nvm 指令,表示你還沒安裝 Node Version Manager(nvm)。


✅ 什麼是 nvm?

  • nvm 是一個非常方便的工具,可以讓你在同一台電腦上輕鬆切換和管理多個 Node.js 版本。
  • 用它可以快速升級或切換到符合 Vite 要求的 Node 版本,避免版本衝突。

✅ macOS 安裝 nvm 步驟

  1. 打開終端機(Terminal),執行安裝指令:
1
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
  1. 安裝完成後,重新開啟終端機,或執行:
1
2
export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
  1. 確認安裝成功:
1
nvm --version

應該會看到版本號,例如 0.39.5


✅ 使用 nvm 安裝符合需求的 Node.js 版本

1
2
nvm install 20.19.0
nvm use 20.19.0

切換到指定版本後,再確認:

1
node -v

✅ 之後就能正常執行你的 Vite 專案


如果你想,我可以幫你一步一步寫出指令和操作說明!
或是幫你解釋如何在 macOS zsh 設定檔中加入 nvm 初始化指令。

你問得非常好!來,我一步一步說明:


source ~/.zshrc 是什麼意思?

這個指令的意思是:

重新載入你的 shell 設定檔 ~/.zshrc,讓剛剛安裝或修改的設定馬上生效。


📁 ~/.zshrc 是什麼?

  • 是一個隱藏檔案,存在你使用者目錄下(~ 就是 /Users/你的名字/

  • 是 macOS 預設 shell(Zsh)的啟動設定檔

  • 裡面會放像:

    • 安裝 nvm 需要的設定
    • export 環境變數
    • alias 指令別名設定

❓ 為什麼沒有任何訊息?

這是正常的

  • source ~/.zshrc 只是重新載入設定
  • 沒有錯誤,它就不會輸出任何東西

✅ 要如何確認 source ~/.zshrc 有成功?

你可以打這個指令來確認:

1
command -v nvm

如果有安裝成功並載入 .zshrc,會顯示:

1
nvm

👇 如果沒有顯示?

可能是 .zshrc 裡面還沒正確加上 nvm 的初始化程式碼。你可以打開 .zshrc 檔確認是否有:

1
2
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

如果有,再打一次:

1
source ~/.zshrc

然後再測試:

1
nvm --version