# NVM 和 Node.js 14 Macos解压安装指南
---
作者： gwozai
版权声明： 本文档由 gwozai 创建，版权所有 © gwozai。转载请注明出处。
创建时间： 2025
适用系统： macOS
---
## 一、安装 NVM
下载链接： https://myfileforever.lanzouq.com/izg1u31gxt9c
### 1. 解压 nvm
```bash
# 创建 .nvm 目录
mkdir -p ~/.nvm
# 解压 nvm-0.40.3.tar.gz 到 .nvm 目录
tar -xzf nvm-0.40.3.tar.gz --strip-components 1 -C ~/.nvm
```
### 2. 配置环境变量（选择你使用的 shell）
对于 zsh（~/.zshrc）：
```bash
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc
echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.zshrc
echo '[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"' >> ~/.zshrc
```
对于 bash（~/.bashrc）：
```bash
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.bashrc
echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.bashrc
echo '[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"' >> ~/.bashrc
```
### 3. 重新加载配置
```bash
source ~/.zshrc # 如果使用 zsh
# 或
source ~/.bashrc # 如果使用 bash
```
### 4. 验证 nvm 安装
```bash
nvm --version # 应显示 0.40.3
```
## 二、安装 Node.js 14
下载链接： https://myfileforever.lanzouq.com/ih5sy31gxtfi
### 1. 创建目标目录
```bash
mkdir -p ~/.nvm/versions/node/v14.21.3
```
### 2. 解压 Node.js
```bash
tar -xzf node-v14.21.3-darwin-x64.tar.gz --strip-components 1 -C ~/.nvm/versions/node/v14.21.3
```
### 3. 使用该版本
```bash
nvm use 14.21.3
```
### 4. 验证安装
```bash
node --version # 应显示 v14.21.3
npm --version # 应显示对应的 npm 版本
```
## 三、设置默认版本
### 设置 Node.js 14 为默认版本
```bash
nvm alias default 14.21.3
```
### 或设置其他版本为默认（如 Node.js 16）
```bash
nvm alias default 16.20.1
```
## 四、常用 NVM 命令
```bash
nvm ls # 列出已安装的版本
nvm use <版本> # 切换版本
nvm current # 显示当前使用的版本
nvm alias default <版本> # 设置默认版本
```
## 五、npm 配置优化
### 设置国内镜像源（提高下载速度）
```bash
npm config set registry https://registry.npmmirror.com
```
### 其他常用 npm 配置
```bash
# 查看当前配置
npm config list
# 恢复官方源
npm config set registry https://registry.npmjs.org/
```
## 六、目录结构参考
安装完成后的目录结构应如下：
```
~/.nvm/
├── nvm.sh # nvm 主脚本
├── bash_completion # 命令补全脚本
├── versions/
│ └── node/
│ └── v14.21.3/ # Node.js 安装目录
│ ├── bin/ # 可执行文件目录
│ ├── include/ # 头文件目录
│ ├── lib/ # 库文件目录
│ └── share/ # 共享资源目录
```
## 七、故障排除
### 1. 如果 nvm 命令未找到
- 检查 .nvm 目录是否存在
- 确认环境变量是否正确配置
- 重新加载 shell 配置文件
### 2. 如果 Node.js 版本未被识别
- 检查版本目录结构是否正确
- 确保文件权限正确
- 运行 nvm ls 检查版本列表
### 3. 如果 npm 不可用
- 检查 bin 目录下的可执行文件
- 确保文件具有执行权限
- 重新加载 nvmsource ~/.nvm/nvm.sh
---
注意： 本指南适用于 macOS 系统，其他系统请根据实际情况调整相关路径和命令。
---
## 版权信息
文档作者： gwozai
版权所有： © 2025 gwozai. All rights reserved.
许可协议： 本文档采用知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议进行许可
免责声明： 本文档仅供学习参考使用，作者不对因使用本文档内容而产生的任何问题承担责任
更新日期： 2025年
> 如有疑问或建议，欢迎联系作者 gwozai
