跳至主要内容

[NodeJS] 透過 NVM 安裝與使用 Node.js

nvm install <version>           # 安裝某個版本的 node
nvm uninstall <version>         # 解除安裝指定版本
nvm use [version]               # 使用某個版本的 node
nvm ls                          # 列出本機已安裝的版本
nvm ls-remote                   # 列出所有可安裝版本
nvm alias default <version>     # 設定預設開啟的 node 版本
nvm --version                   # 查看 nvm 版本
nvm which 8.11.1                # 查看某一版本 nvm 的 PATH

安裝或更新 nvm​

MacOS​

# 安裝
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.37.2/install.sh | bash

# 重新開啟 Terminal 後，檢測是否安裝成功
command -v nvm        # nvm

在 MacOS X 上，如果安裝後卻出現 nvm: command not found 的話，有可能是因為：

  • 系統尚未擁有 .bash_profile 這支檔案，因此只需先透過 touch ~/.bash_profile 建立這支檔案，接著再重新執行一次安裝程序。
  • 安裝完成後重新啟動終端機。

如果上面的方式還是無法解決問題，打開你的 .bash_profile 檔案，並且加入下面這段程式：

source ~/.bashrc

NVM MacOS @ Github

補充：問題解決​

在安裝 nvm 時，nvm 會自動將下述指令新增到 .bashrc 中：

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion

但在 Mac 的作業系統下，直接打開 Terminal 只會載入 .bash_profile 而不會載入 .bashrc 這支檔案，因此為了要可以吃到 nvm 在 .bashrc 中設定好的變數，需要在 .bash_profile 中加上：

source $HOME/.bashrc

或者，如果你不確定 .bashrc 是否存在，存在時才載入該檔案的話，可以寫成：

if [ -f $HOME/.bashrc ]; then
  source $HOME/.bashrc
fi

因此，若無法順利執行 nvm 需要確認兩件事：

  1. .bashrc 中已經有 export NVM_DIR=... 這段指令，沒有的話複製進去。
  2. .bash_profile 中有 source $HOME/.bashrc 這段指令，沒有的話複製進去。

一般來說，.bash_profile 是給 login shell 使用的；而 .bashrc 則是給 non-login shells 使用的。在 MAC OSX 系統下，打開 Terminal 時預設都是使用 login shell，因此載入的是 .bash_profile 這隻檔案。

What is the difference between bash_profile and bashrc @ stackExchange

遇到下載不到正確的版本（下載很久）​

不確定原因，但在 Mac M1 晶片上，有些電腦在安裝 node 時會抓到不存在的版本，例如：

# nvm 試著下載不存在的這個版本
https://nodejs.org/dist/v14.21.0/node-v14.21.0-darwin-arm64.tar.xz

# 但有得電腦又能正確載到這個
https://nodejs.org/dist/v14.21.0/node-v14.21.0-darwin-x64.tar.xz

遇到這個問題的時候，nvm 會試著載一大包在本地 compile，導致下載很久很久，遇到這個問題的話，可以參考這篇（nvm install node fails to install on macOS Big Sur M1 Chip）的解決方式。

.nvmrc​

.nvmrc @ nvm

透過在專案中放置 .nvmrc 可以讓 nvm 知道該專案套用的 node 版本為何：

echo "14.17.0" > .nvmrc   # 指定專案中適用的 node 版本

進到該專案資料夾後，直接數入 nvm use 後，nvm 會自動套用該專案的 node 版本。

如果覺得還要手動輸入 nvm use 太過麻煩，可以在 ~/.zshrc 中貼上下述指令，如此會在進到該專案資料夾時，自動切換到對應的 node 版本：

# ~/.zshrc
# https://github.com/nvm-sh/nvm#zsh
# place this after nvm initialization!
autoload -U add-zsh-hook
load-nvmrc() {
  local node_version="$(nvm version)"
  local nvmrc_path="$(nvm_find_nvmrc)"

  if [ -n "$nvmrc_path" ]; then
    local nvmrc_node_version=$(nvm version "$(cat "${nvmrc_path}")")

    if [ "$nvmrc_node_version" = "N/A" ]; then
      nvm install
    elif [ "$nvmrc_node_version" != "$node_version" ]; then
      nvm use
    fi
  elif [ "$node_version" != "$(nvm version default)" ]; then
    echo "Reverting to nvm default version"
    nvm use default
  fi
}
add-zsh-hook chpwd load-nvmrc
load-nvmrc

Windows​

NVM Windows @ Github

其他問題​

參考​