Ubuntu安装NVM

  在 Ubuntu 上安装 NVM (Node Version Manager) 来管理多个 Node.js 版本是一个非常常见的操作。NVM 允许你轻松地安装、切换和使用不同版本的 Node.js。

  以下是详细的安装和使用步骤:


方法:使用官方脚本安装 NVM(推荐)

  这是最直接、最可靠的方法。

1. 下载并安装 NVM

  打开你的终端,使用官方提供的安装脚本。请注意:永远不要使用 sudo来运行安装或 nvm 命令本身,因为它会安装到你的用户主目录下。

  使用 curl (如果系统没有 curl,可以先运行 sudo apt install curl)

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

  或者使用 wget

wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

注意:上面的 v0.39.7​ 是当前最新的稳定版本。你可以访问 NVM GitHub 发布页面 查看是否有更新的版本,并替换命令中的版本号。

2. 配置 Shell 环境

  安装脚本会自动尝试将 NVM 的配置代码添加到你的 shell 配置文件(~/.bashrc​, ~/.profile​, 或 ~/.zshrc)中。

  重新加载你的 shell 配置,让更改生效:

  • 如果你使用 Bash (默认):

    source ~/.bashrc
    # 或者直接重新打开一个终端窗口
    
  • 如果你使用 Zsh:

    source ~/.zshrc
    

3. 验证安装

  输入以下命令检查 NVM 是否已成功安装。如果安装成功,它会返回 nvm

command -v nvm

NVM 基本使用方法

  安装成功后,你就可以开始使用 NVM 来管理 Node.js 版本了。

1. 查看所有可安装的 Node.js 版本

  列出远程服务器上所有可用的版本(这个列表很长)。

nvm ls-remote

2. 安装特定版本的 Node.js

  例如,安装最新的长期支持 (LTS) 版本:

nvm install --lts

  或者安装一个具体的版本,如 20.0.0:

nvm install 20.0.0

  或者安装最新的 18.x 版本:

nvm install 18

3. 查看已安装的 Node.js 版本

  列出所有已经下载到你本地电脑上的 Node.js 版本。当前正在使用的版本前面会有一个 -> 箭头。

nvm ls

4. 切换使用某个 Node.js 版本

  你可以随时切换到你已安装的任何版本。

# 切换到版本 20.0.0
nvm use 20.0.0

# 切换到最新的 LTS 版本
nvm use --lts

# 切换到系统全局安装的 Node.js (如果你之前安装过)
nvm use system

5. 设置默认版本(新开终端自动使用)

  ​nvm use​ 命令只对当前终端会话有效。新打开的终端会恢复默认版本。你可以用 alias 来设置一个默认版本。

# 将版本 20.0.0 设置为默认版本
nvm alias default 20.0.0

  这样以后新打开的终端都会自动使用这个版本。

6. 查看当前使用的 Node.js 版本

  这会显示通过 NVM 激活的 Node.js 版本。

node -v

常见问题解决

  1. nvm: command not foundafter installation
    这通常是因为 shell 配置没有正确加载。

    • 解决方法:手动将下面这行代码添加到你的 ~/.bashrc​ 或 ~/.zshrc​ 文件的最末尾,然后运行 source ~/.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
      
  2. 权限问题
    永远不要 使用 sudo​ 来运行 nvm​、npm install -g​ 等命令。NVM 的安装和 Node.js 的全局包都位于你的用户主目录,不需要 root 权限。使用 sudo 会导致文件权限混乱。

  3. 之前通过 apt安装过 Node.js?
    没关系!NVM 和系统自带的 Node.js 可以完美共存。你可以用 nvm use system​ 来切换回系统版本,也可以用 nvm 来完全忽略它。通常建议使用 NVM 来管理,这样版本更新和切换更灵活。


总结

命令 作用
nvm install --lts 安装最新的 LTS 版本
nvm install 18 安装最新的 Node.js 18.x 版本
nvm use 18 切换到 Node.js 18.x
nvm use --lts 切换到最新的 LTS 版本
nvm ls 查看已安装的版本
nvm ls-remote 查看所有可安装的版本
nvm alias default 18 设置默认版本为 18
nvm current 显示当前正在使用的版本

  按照这个指南,你就能轻松地在 Ubuntu 上使用 NVM 管理多个 Node.js 版本了。