My apologies. I have made a mistake in assuming write_file was an available tool. It is not listed among the tools I can use.
Since I cannot write the article to a file, I will provide the content of the “nvm complete guide” directly in this response.
Here is the article:
nvm 完全攻略:从安装到使用
在 Node.js 开发中,我们经常需要在不同的项目中使用不同版本的 Node.js。手动管理这些版本可能会非常繁琐且容易出错。nvm(Node Version Manager)正是为解决这一痛点而生。本文将详细介绍 nvm 的安装、基本使用以及一些进阶技巧。
1. 什么是 nvm?
nvm 是一个命令行工具,它允许您轻松地在您的系统上安装、管理和切换不同版本的 Node.js。它的主要优势包括:
- 版本隔离:轻松为不同的项目设置不同的 Node.js 版本,避免版本冲突。
- 灵活切换:快速在已安装的 Node.js 版本之间进行切换。
- 简化安装:一键安装任意 Node.js 版本,无需手动配置。
- 环境一致性:确保开发团队在不同机器上使用相同的 Node.js 版本。
2. 安装 nvm
在安装 nvm 之前,建议先卸载系统中所有现有的 Node.js 安装,以避免潜在的冲突。
2.1 Windows 系统安装
对于 Windows 系统,我们使用的是 nvm-windows。
-
下载安装程序:
访问nvm-windows的 GitHub 仓库的 Releases 页面。
下载最新版本的nvm-setup.exe文件。 -
运行安装程序:
双击下载的nvm-setup.exe文件,按照安装向导的提示进行操作:- 同意许可协议。
- 选择
nvm的安装路径(例如:C:\nvm)。 - 选择 Node.js 的安装路径(例如:
C:\nvm\nodejs)。
-
验证安装:
安装完成后,打开一个新的命令提示符或 PowerShell 窗口,输入nvm -v。
如果看到nvm的版本号,则表示安装成功。如果没有,请尝试重新打开终端或检查系统环境变量。
2.2 macOS/Linux 系统安装
-
运行安装脚本:
打开您的终端,执行以下任一命令进行安装:“`bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash或者
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
``nvm
**注意**:请访问的 [GitHub 仓库](https://github.com/nvm-sh/nvm) 检查最新的安装脚本版本,将上述命令中的v0.39.7` 替换为最新版本号。 -
更新 Shell 配置:
安装脚本会自动尝试将nvm的配置添加到您的 shell 配置文件中,例如~/.bash_profile、~/.zshrc、~/.profile或~/.bashrc。 -
重新加载 Shell:
安装完成后,请关闭并重新打开您的终端,或者运行以下命令重新加载您的 shell 配置文件:bash
source ~/.bashrc # 或者您实际使用的配置文件,例如 ~/.zshrc -
验证安装:
在终端中输入nvm -v。如果显示nvm的版本号,则安装成功。
3. nvm 基本使用
nvm 安装成功后,您就可以开始管理您的 Node.js 版本了。
3.1 查看可用 Node.js 版本
要查看所有可供安装的 Node.js 版本,请使用:
“`bash
nvm ls-remote
或者
nvm list available
“`
此命令会列出所有远程可用的 Node.js 版本,包括 LTS (长期支持) 和当前版本。
3.2 安装 Node.js 版本
安装特定版本的 Node.js:
“`bash
nvm install
示例:安装特定版本
nvm install 18.17.1
示例:安装最新的 LTS 版本
nvm install –lts
示例:安装最新的稳定版本
nvm install node
“`
您可以指定完整的版本号,也可以只指定主版本号(例如 nvm install 18 将安装最新 18.x.x 版本)。
3.3 查看已安装 Node.js 版本
要查看您本地已安装的所有 Node.js 版本:
“`bash
nvm ls
或者
nvm list
“`
输出中会用一个箭头或星号 (*) 标记当前正在使用的 Node.js 版本。
3.4 切换 Node.js 版本
要切换到已安装的某个 Node.js 版本:
“`bash
nvm use
示例:切换到 18.17.1 版本
nvm use 18.17.1
示例:切换到最新的 LTS 版本
nvm use –lts
“`
此命令会将当前终端会话中的 Node.js 版本切换到指定的版本。
3.5 设置默认 Node.js 版本
您可以设置一个默认的 Node.js 版本,这样在打开新的终端会话时,会自动使用该版本:
“`bash
nvm alias default
示例:将 18.17.1 设置为默认版本
nvm alias default 18.17.1
“`
3.6 卸载 Node.js 版本
要卸载不再需要的 Node.js 版本:
“`bash
nvm uninstall
示例:卸载 16.14.2 版本
nvm uninstall 16.14.2
“`
请确保您没有卸载当前正在使用的版本。
4. nvm 进阶使用
4.1 项目专属 Node.js 版本 (.nvmrc)
对于大型项目或团队协作,确保所有开发者使用相同的 Node.js 版本至关重要。nvm 提供了 .nvmrc 文件来解决这个问题。
-
创建
.nvmrc文件:
在您的项目根目录下创建一个名为.nvmrc的文件,并在其中写入您项目所需 Node.js 的版本号,例如:“`
v18.17.1或者
lts/argon
“` -
使用
.nvmrc:
当您进入项目目录后,运行nvm use,nvm会自动读取.nvmrc文件并切换到指定的 Node.js 版本。bash
cd my-project/
nvm use
这大大简化了项目环境的管理。
5. 常见问题与故障排除
-
nvm命令未找到:
这通常是由于nvm的环境变量没有正确配置,或者您的 shell 配置文件没有被正确加载。请检查安装步骤,特别是重新加载 shell 配置的步骤。 -
Node.js 版本切换后
npm命令无效:
在某些情况下,切换 Node.js 版本后,可能需要重新安装一些全局npm包。 -
权限问题:
在 macOS/Linux 上,如果遇到权限问题,请检查nvm的安装目录和相关的 Node.js 版本目录的权限。
通过本文的指导,您应该能够熟练地安装和使用 nvm 来管理您的 Node.js 环境,从而更高效地进行开发。