Linux NVM Guide

在 Linux 上，nvm (Node Version Manager) 是管理多个 Node.js 版本的主流工具，它允许你在同一台机器上安装、切换和隔离不同项目所需的 Node.js 版本。

📥 安装 nvm

推荐使用官方安装脚本。根据你的环境，选择 curl 或 wget 命令：

使用 curl:

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

使用 wget:

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

安装脚本会自动将 nvm 仓库克隆到 ~/.nvm，并尝试将环境变量配置添加到你的 shell 配置文件（如 ~/.bashrc 或 ~/.zshrc）中。

⚙️ 激活与验证

安装后，需要让配置生效：

bash
# 如果使用 Bash
source ~/.bashrc
# 如果使用 Zsh
source ~/.zshrc

或者，直接关闭当前终端并重新打开一个即可。

验证安装：运行以下命令，如果显示版本号（如 0.40.3）即表示成功：

bash
nvm --version

🎮 常用命令

掌握以下命令即可高效管理 Node.js 版本：

命令	说明
`nvm install --lts`	安装最新的 LTS (长期支持) 版本
`nvm install 20.11.0`	安装指定的 Node.js 版本
`nvm ls`	列出已安装的所有版本（当前使用版本前有 `->` 标记）
`nvm ls-remote`	列出远程所有可用的版本
`nvm use 20.11.0`	临时切换版本（仅对当前终端会话有效）
`nvm alias default 20.11.0`	设置默认版本（新打开的终端都会使用）
`nvm uninstall 18.0.0`	卸载指定的 Node.js 版本

📁 项目级版本控制 (`.nvmrc`)

在项目根目录创建 .nvmrc 文件，写入项目所需的 Node.js 版本号，例如：

bash
echo "20.11.0" > .nvmrc

之后，进入该目录时执行 nvm use，nvm 就会自动读取并切换到对应版本。如果该版本尚未安装，它会给出提示。

🇨🇳 配置国内镜像（加速下载）

国内网络环境下，可以设置镜像环境变量来加速 Node.js 的下载。将以下内容添加到你的 shell 配置文件（如 ~/.bashrc）中：

bash
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
export NVM_IOJS_ORG_MIRROR=https://npmmirror.com/mirrors/iojs

保存后执行 source ~/.bashrc 使其生效。之后使用 nvm install 时便会从国内镜像下载。

🗑️ 卸载 nvm

如果你需要彻底移除 nvm：

移除 nvm 目录：
```
bash
rm -rf ~/.nvm
```
清理 shell 配置：编辑 ~/.bashrc、~/.zshrc 或 ~/.profile，删除其中所有与 NVM_DIR 相关的行。

🔧 常见问题排查

问题1：安装后执行 nvm 提示 command not found

这通常是因为 shell 配置文件未被正确加载。你可以尝试：

重启终端：关闭所有终端窗口，重新打开一个再试。
手动加载：在终端中手动执行 source ~/.bashrc（或你的 shell 对应文件）。
检查配置：确认 ~/.bashrc（或 ~/.zshrc）中已包含安装脚本添加的 export NVM_DIR... 和 [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" 这两行配置。

问题2：touch ~/.bashrc 创建了为啥看不到

因为 ~/.bashrc 是隐藏文件——文件名以 . 开头。ls 默认不显示隐藏文件

列出主目录下所有文件，包括隐藏文件：

bash
ls -a ~

图形界面看不到如果你是在 Finder 或文件管理器里看，隐藏文件默认也不显示：

macOS Finder：按 Cmd + Shift + . 显示隐藏文件。

Linux 文件管理器：一般按 Ctrl + H 显示隐藏文件。

NPM 镜像查询与设置

bash
npm config get registry

npm config set registry https://registry.npmmirror.com

Vim操作

在 vim 里保存退出，记住这个核心操作：

按 O（大写字母 O），这会在当前行的上方插入一个新行，并进入插入模式

先按 Esc，再输入 :wq，然后按回车。

常见场景

目的	操作
保存并退出	`Esc` → `:wq` → 回车
保存并退出（等价）	`Esc` → `:x` → 回车
不保存，强制退出	`Esc` → `:q!` → 回车
只保存，不退出	`Esc` → `:w` → 回车
没修改，只想退出	`Esc` → `:q` → 回车
保存退出（快捷键）	`Esc` → 按 `ZZ`（Shift+z 两次）

注意

先按 Esc
如果你在插入模式（正在打字），要先按 Esc 回到普通模式，才能输入 : 命令。不确定时多按几次 Esc 也没关系。
冒号是英文冒号
输入 : 时要用英文输入法，不要用中文的 ：。
如果提示权限不够
比如编辑系统文件时出现 E45: 'readonly' option is set，可以用：
```
:w !sudo tee %
```
回车后输入密码，再按 :q! 退出。不过编辑 ~/.bashrc、~/.zshrc 一般不需要 sudo。

你正在编辑 .zshrc / .bashrc 的话

保存退出后，运行对应命令让配置生效：

zsh：
```
bash
source ~/.zshrc
```
bash：
```
bash
source ~/.bashrc
```

然后可以用 echo $NVM_NODEJS_ORG_MIRROR 验证是否生效。

目录