nvm 完全攻略:从安装到使用 – wiki词典

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

  1. 下载安装程序
    访问 nvm-windows 的 GitHub 仓库的 Releases 页面
    下载最新版本的 nvm-setup.exe 文件。

  2. 运行安装程序
    双击下载的 nvm-setup.exe 文件,按照安装向导的提示进行操作:

    • 同意许可协议。
    • 选择 nvm 的安装路径(例如:C:\nvm)。
    • 选择 Node.js 的安装路径(例如:C:\nvm\nodejs)。
  3. 验证安装
    安装完成后,打开一个新的命令提示符或 PowerShell 窗口,输入 nvm -v
    如果看到 nvm 的版本号,则表示安装成功。如果没有,请尝试重新打开终端或检查系统环境变量。

2.2 macOS/Linux 系统安装

  1. 运行安装脚本
    打开您的终端,执行以下任一命令进行安装:

    “`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` 替换为最新版本号。

  2. 更新 Shell 配置
    安装脚本会自动尝试将 nvm 的配置添加到您的 shell 配置文件中,例如 ~/.bash_profile~/.zshrc~/.profile~/.bashrc

  3. 重新加载 Shell
    安装完成后,请关闭并重新打开您的终端,或者运行以下命令重新加载您的 shell 配置文件:

    bash
    source ~/.bashrc # 或者您实际使用的配置文件,例如 ~/.zshrc

  4. 验证安装
    在终端中输入 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 文件来解决这个问题。

  1. 创建 .nvmrc 文件
    在您的项目根目录下创建一个名为 .nvmrc 的文件,并在其中写入您项目所需 Node.js 的版本号,例如:

    “`
    v18.17.1

    或者

    lts/argon
    “`

  2. 使用 .nvmrc
    当您进入项目目录后,运行 nvm usenvm 会自动读取 .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 环境,从而更高效地进行开发。

滚动至顶部