幕雪

npm安装教程是什么、为什么、如何安装与常见问题解决

本篇文章将围绕【npm安装教程】这一核心，详细解答您在安装和使用 npm 过程中可能遇到的各种疑问。我们将从 npm 是什么开始，解释为何需要安装它，告诉您从哪里获取安装文件以及是否需要费用，并提供详细的安装步骤（包括不同操作系统和常见方法），最后指导您如何验证安装结果以及如何解决安装过程中可能遇到的问题。

什么事 npm？为什么需要安装？

npm 是 Node.js 的包管理器（Node Package Manager）。简单来说，它是一个工具，帮助 JavaScript 开发者共享和使用代码包（即模块或库）。想象一下，您在做一个项目，需要用到一个功能，比如处理日期或发起网络请求，通常不需要自己从零开始编写这些复杂的代码。npm 仓库里已经有成千上万个由其他开发者写好的、可复用的代码包。

为什么需要安装 npm？ 因为 npm 是您获取和管理这些代码包的入口。几乎所有的现代前端和后端 JavaScript 项目（使用 Node.js）都会依赖 npm 来安装项目所需的各种库。没有 npm，您将很难高效地构建和维护复杂的 JavaScript 应用。安装 npm 是进行 Node.js 开发、前端框架（如 React, Vue, Angular）开发、构建工具（如 Webpack, Parcel）使用等各种工作的先决条件。

安装 npm 的先决条件是什么？

npm 实际上是和 Node.js 捆绑安装的。这意味着，您通常不需要单独安装 npm，只需要安装 Node.js 即可。当您成功安装 Node.js 后，npm 也会自动安装到您的系统中。所以，安装 npm 的先决条件就是：

  • 您的操作系统：Node.js 和 npm 支持 Windows、macOS 和 Linux 等主流操作系统。
  • 基本的命令行或终端操作知识：安装和验证通常需要在命令行界面进行。
  • 稳定的网络连接：下载安装包和后续使用 npm 安装其他依赖都需要网络。

从哪里获取 npm 安装包？需要多少费用？

如前所述，npm 是随 Node.js 一起发布的。所以，您需要从 Node.js 官方网站下载安装包。

  • 官方网站地址： nodejs.org

在官方网站上，您通常会看到两个主要下载选项：

  1. LTS 版本（Long Term Support，长期支持版）：这是推荐给大多数用户的版本，它经过充分测试，更稳定，提供更长时间的支持和维护。
  2. Current 版本（当前最新版）：包含最新的特性，但可能不够稳定，适合尝鲜或测试新功能。

对于初学者和大多数生产环境应用，强烈建议选择 LTS 版本。

关于费用：安装和使用 Node.js 和 npm 是完全免费的。它们都是开源软件。您可以自由下载、安装和使用它们，无需支付任何费用。

如何安装 npm (核心教程)？

最常用和推荐的方式是安装 Node.js。以下是针对不同操作系统的安装步骤：

方法一：安装 Node.js (推荐)

Windows 系统安装 Node.js

  1. 访问官网： 打开浏览器，前往 nodejs.org。
  2. 下载安装包： 在官网首页，点击 LTS 版本下方的 Windows Installer (.msi) 链接。根据您的系统架构（32位或64位）选择对应的版本下载。如果您不确定，通常下载 64位版本即可。
  3. 运行安装程序： 找到下载好的 .msi 文件，双击运行。
  4. 完成安装向导：

    • 点击 Run（如果出现安全警告）。
    • 在安装向导界面点击 Next。
    • 接受许可协议，点击 Next。
    • 选择安装路径（通常保持默认即可），点击 Next。
    • 选择需要安装的组件。请确保 “Node.js runtime” 和 “npm package manager” 都被选中。通常默认就是全选的。点击 Next。
    • （可选步骤，通常不需要勾选）Native modules 的工具安装。如果您的项目后续需要编译C/C++等原生模块，可以勾选，安装程序会额外下载和安装 Python 和 Build Tools。这不是 npm 或 Node.js 本身运行必须的，可以在需要时单独安装。为简化安装，初次安装可以不勾选。点击 Next。
    • 点击 Install 开始安装。
    • 等待安装完成，点击 Finish。
  5. 验证安装： 安装程序通常会自动配置环境变量 PATH。打开一个新的命令提示符窗口（Command Prompt）或 PowerShell（注意：如果安装前已经打开了命令行窗口，需要关闭重开才能识别新安装的命令）。输入以下命令并回车：

    node -v

    npm -v

    如果安装成功，它们会分别显示 Node.js 和 npm 的版本号。

    如果您在旧的命令行窗口中验证失败，一定要关闭并重新打开一个新窗口再试。

macOS 系统安装 Node.js

  1. 访问官网： 打开浏览器，前往 nodejs.org。
  2. 下载安装包： 在官网首页，点击 LTS 版本下方的 macOS Installer (.pkg) 链接下载。
  3. 运行安装程序： 找到下载好的 .pkg 文件，双击运行。
  4. 完成安装向导：

    • 点击 继续。
    • 阅读并同意许可协议，点击 继续 -> 同意。
    • 选择安装位置（通常保持默认即可），点击 继续。
    • 点击 安装。
    • 系统可能会要求输入您的管理员密码，输入后点击 安装软件。
    • 等待安装完成。
    • 安装成功后，点击 关闭。安装程序可能会提示将安装包移到废纸篓，您可以选择保留或移除。
  5. 验证安装： 打开“终端”（Terminal）应用程序。输入以下命令并回车：

    node -v

    npm -v

    如果安装成功，它们会分别显示 Node.js 和 npm 的版本号。

    与 Windows 类似，如果终端窗口在安装前已打开，可能需要关闭并重新打开才能识别新安装的命令。

Linux 系统安装 Node.js

Linux 系统安装 Node.js 有多种方法，最推荐的是使用您发行版自带的包管理器或者 NodeSource 提供的二进制仓库。

  1. 使用包管理器 (推荐 for 快速入门，版本可能不是最新 LTS)：

    • Debian/Ubuntu 系统：

      打开终端，运行以下命令：

      sudo apt update

      sudo apt install nodejs npm

      这种方法安装的 Node.js 和 npm 版本可能不是最新的 LTS 版本，而是您发行版仓库中维护的版本。

    • Fedora 系统：

      打开终端，运行以下命令：

      sudo dnf install nodejs npm

    • CentOS/RHEL 系统：

      可能需要先启用 EPEL 仓库：

      sudo yum install epel-release

      然后安装 Node.js 和 npm：

      sudo yum install nodejs npm –enablerepo=epel

    • 其他发行版： 请查阅您发行版关于安装 Node.js 的文档，通常是 `sudo [您的包管理器] install nodejs npm`。
  2. 使用 NodeSource 二进制仓库 (推荐 for 最新 LTS)：

    NodeSource 为许多 Linux 发行版提供了最新的 Node.js 二进制安装包。

    • 以 Node.js 18 (LTS) 为例 (不同版本请替换 18.x)：

      打开终端，运行以下命令来添加仓库并安装（适用于 Debain/Ubuntu/Linux Mint）：

      curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash –

      sudo apt-get install -y nodejs

      对于 RHEL/CentOS/Fedora 等系统，请查阅 NodeSource 的官方说明获取对应命令。

  3. 从官网下载二进制包：

    您也可以从 nodejs.org 下载 Linux Binaries (.tar.xz) 文件，然后手动解压到指定目录，并配置环境变量 PATH。这种方法比较繁琐，不建议初学者使用。

  4. 验证安装： 打开终端，输入以下命令并回车：

    node -v

    npm -v

    如果安装成功，它们会分别显示 Node.js 和 npm 的版本号。

方法二：使用 Node.js 版本管理器 (例如 NVM)

对于需要在同一台机器上管理多个 Node.js 版本（以及对应版本的 npm）的开发者，使用版本管理器是一个更好的选择。著名的版本管理器有 NVM (Node Version Manager)，它支持 macOS 和 Linux 系统。Windows 系统有 nvm-windows 或 Volari。这里以 NVM (for macOS/Linux) 简单说明：

  1. 安装 NVM： 按照 NVM 的官方文档说明进行安装。通常是在终端运行一个 curl 或 wget 命令。

    例如 (请查阅官方仓库获取最新安装命令)：

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

    安装完成后，可能需要关闭并重新打开终端或运行源文件命令（如 `source ~/.bashrc` 或 `source ~/.zshrc`）使 NVM 命令生效。

  2. 通过 NVM 安装 Node.js (含 npm)： 使用 NVM 命令安装您需要的 Node.js 版本。

    安装最新的 LTS 版本：nvm install –lts

    安装特定版本 (例如 18.16.0)：nvm install 18.16.0

    NVM 会下载并安装指定版本的 Node.js，同时该版本的 npm 也会被安装。NVM 会自动设置环境变量，让您可以在当前终端使用该版本的 Node.js 和 npm。

  3. 切换 Node.js 版本： 如果安装了多个版本，可以使用 `nvm use [version]` 命令切换。

    例如：nvm use 18.16.0

  4. 验证安装： 在使用 NVM 安装并切换到某个版本后，同样使用 `node -v` 和 `npm -v` 命令验证当前使用的版本。

使用版本管理器安装 npm 实际上是通过安装 Node.js 来实现的，它提供了更灵活的版本管理能力。

安装完成后如何验证？

安装 Node.js (包含 npm) 后，最关键的验证步骤是检查 `node` 和 `npm` 命令是否能在您的终端或命令行中正常执行，并显示正确的版本信息。

请打开一个新的命令行窗口或终端，然后依次输入以下两个命令并按回车键：

node -v

这个命令用于检查 Node.js 是否安装成功，并显示其版本号（例如：`v18.16.0`）。

npm -v

这个命令用于检查 npm 是否安装成功，并显示其版本号（例如：`9.6.7`）。

如果这两个命令都能正确输出版本号，说明 Node.js 和 npm 已经成功安装并配置好了系统环境。您可以开始使用 npm 来管理您的项目依赖了。

安装过程中可能遇到的问题及解决方法

问题一：’node’ 不是内部或外部命令，也不是可运行的程序或批处理文件。 (‘node’ is not recognized…)

原因： 这通常是由于系统环境变量 PATH 没有正确配置，导致系统找不到 `node` 或 `npm` 命令所在的目录。Node.js 安装程序通常会自动配置 PATH，但有时可能会失败或需要重新打开命令行窗口才能生效。

解决方法：

  1. 首先，确保您关闭了安装前打开的所有命令行窗口，然后重新打开一个新窗口再试。
  2. 如果问题依旧，您需要手动检查和配置系统的环境变量 PATH。

    • Windows：

      右键点击“此电脑”或“计算机” -> “属性” -> “高级系统设置” -> “环境变量”。在“系统变量”列表中找到名为“Path”的变量，双击编辑。确保其中包含了 Node.js 的安装路径下的 `node.exe` 和 `npm` 相关文件所在的目录（例如：`C:\Program Files\nodejs\`）。如果没有，点击“新建”添加该路径。添加或修改后，一路点击“确定”保存设置。然后必须关闭所有命令行窗口，重新打开一个新窗口再验证。

    • macOS/Linux：

      Node.js 通常安装在 `/usr/local/bin` 或类似的目录，这些目录通常已经在系统的 PATH 中。如果使用 NVM 安装，NVM 会自动管理 PATH。如果手动安装或路径有问题，您可能需要编辑您的 shell 配置文件（如 `~/.bashrc`, `~/.zshrc`, `~/.profile` 等），在文件中添加类似这样一行来将 Node.js 的 bin 目录添加到 PATH 中：

      export PATH=”/usr/local/bin:$PATH”

      添加后，保存文件，然后运行 `source ~/.bashrc` (或您的对应文件名) 或关闭重开终端使配置生效。

  3. 确认 Node.js 是否真的安装成功了，尝试重新运行安装程序修复或重新安装。

问题二：npm 安装全局模块时提示权限错误 (EACCES)

原因： 当您尝试使用 `npm install -g [package_name]` 命令全局安装一个包时，npm 默认会尝试将其安装到系统目录（通常是 `/usr/local/lib/node_modules`），这需要管理员权限。如果您没有使用 `sudo`，就会遇到权限不足的错误。

解决方法：

强烈不推荐 直接使用 `sudo npm install -g …` 命令来解决权限问题，因为这可能导致权限混乱，后续更难管理。

推荐的方法是更改 npm 的默认安装目录，使其安装在您有写入权限的用户目录下：

  1. 查找 npm 的默认目录： 在终端运行命令：

    npm config get prefix

    这个命令会显示 npm 当前配置的全局安装路径。

  2. 设置新的全局安装目录： 创建一个您有写入权限的目录，例如在您的用户主目录下创建一个 `.npm-global` 文件夹。

    mkdir ~/.npm-global

    然后配置 npm 将全局模块安装到这个新目录：

    npm config set prefix ‘~/.npm-global’

  3. 将新目录添加到您的 PATH 环境变量： 编辑您的 shell 配置文件（如 `~/.bashrc`, `~/.zshrc` 等），添加以下行：

    export PATH=~/.npm-global/bin:$PATH

    保存文件，然后运行 `source ~/.bashrc` (或您的对应文件名) 或关闭重开终端使配置生效。

这样配置后，当您使用 `npm install -g` 命令时，包会被安装到 `~/.npm-global/lib/node_modules` 目录，而可执行文件（命令）会安装到 `~/.npm-global/bin` 目录。因为后者已经添加到 PATH 中，您就可以直接在终端使用这些命令了，且无需管理员权限。

如果您使用了 NVM 或类似的版本管理器，这个问题通常不会出现，因为版本管理器会将 npm 安装到用户有权限的目录下。

问题三：安装过程下载缓慢或失败 (网络问题)

原因： npm 包默认从官方源 (registry.npmjs.org) 下载，有时因为网络环境问题（如防火墙、代理或连接不稳定）导致下载缓慢或中断。

解决方法：

  1. 检查网络连接： 确保您的网络连接稳定，没有被防火墙或安全软件阻止访问 npm 官方源。
  2. 使用 npm 镜像源： 在中国大陆或其他地区，可以配置 npm 使用国内的镜像源，这样下载速度会快很多。常用的镜像源有淘宝镜像 (npmmirror.com)。

    配置方法（临时使用）：

    npm –registry=https://registry.npmmirror.com install [package_name]

    配置方法（永久使用）：

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

    要恢复使用官方源，可以运行：

    npm config set registry https://registry.npmjs.org/

  3. 清除 npm 缓存： 有时候缓存问题也可能导致安装异常。可以尝试清除缓存：

    npm cache clean –force
  4. 检查代理设置： 如果您使用了网络代理，需要确保 npm 也配置了正确的代理设置。可以查看或设置代理：

    npm config get proxy

    npm config get https-proxy

    npm config set proxy http://your.proxy.com:port

    npm config set https-proxy http://your.proxy.com:port

问题四：Node.js 或 npm 版本过旧

原因： 如果您很早之前安装过 Node.js，或者通过系统自带的包管理器安装的版本不是最新的 LTS 版本，可能会遇到兼容性问题或无法使用新特性。

解决方法：

  1. 更新 Node.js 和 npm： 最彻底的方法是下载最新版本的 Node.js LTS 安装程序，重新运行一遍安装（它会覆盖旧版本）。
  2. 使用版本管理器 (NVM 等)： 如果您经常需要切换或更新 Node.js 版本，强烈推荐使用版本管理器。它可以方便地安装、切换和管理多个版本的 Node.js 和对应的 npm。
  3. 单独更新 npm (不推荐作为常规操作)： 虽然 npm 可以单独更新，但通常建议 npm 的版本与 Node.js 版本配套。Node.js 的新版本通常自带了推荐的 npm 版本。如果确实需要单独更新 npm（例如，Node.js 安装了，但自带的 npm 版本很旧），可以在命令行运行：

    npm install -g npm@latest

    注意，这可能会导致 npm 与 Node.js 版本不兼容的问题，除非您知道自己在做什么，否则尽量通过更新 Node.js 来更新 npm。

总结

npm 是进行现代 JavaScript 开发不可或缺的工具，而安装 npm 最直接有效的方式就是安装 Node.js。只需前往 Node.js 官方网站下载适合您操作系统的 LTS 版本安装包，然后按照安装向导进行即可。安装完成后，通过 `node -v` 和 `npm -v` 验证安装是否成功。如果在安装或使用过程中遇到问题，大多数情况是由于环境变量配置、权限不足或网络问题，可以参考上述的解决方法进行排查。现在，您已经准备好使用 npm 来构建您的下一个精彩项目了！

npm安装教程