幕雪

npm怎么安装Node.js与npm的完整安装、配置及常见问题解决指南

npm，全称Node Package Manager，是Node.js的包管理器，也是前端和后端JavaScript开发中不可或缺的工具。它允许开发者安装、分享和管理项目中的代码包。本文将详细指导您如何安装npm，并提供安装后的验证、更新、常见问题解决方案以及基本使用方法，确保您能顺利踏入Node.js和JavaScript开发的广阔世界。

一、npm是什么？它与Node.js有什么关系？

在深入了解npm的安装过程之前，我们首先需要明确npm和Node.js的概念以及它们之间的紧密联系。

  • Node.js：Node.js是一个开源的、跨平台的JavaScript运行时环境。它允许您在浏览器之外，比如在服务器端或者命令行工具中运行JavaScript代码。Node.js的出现使得JavaScript能够胜任全栈开发。
  • npm：npm是Node.js的默认包管理器。它是一个庞大的软件注册表，包含了数百万个开源代码包（或称模块），开发者可以轻松地通过npm命令行工具来下载、安装、管理和发布这些包，极大地提高了开发效率。

关系：npm与Node.js是共生关系。当您安装Node.js时，npm通常会作为其配套工具自动安装到您的系统中。Node.js提供了JavaScript代码的运行环境，而npm则负责管理和分发这些代码所需的外部库和依赖。没有npm，Node.js的生态系统将难以维持；没有Node.js，npm也无法运行其核心功能。

二、为什么要安装npm？

安装npm对于进行Node.js和现代前端开发至关重要，主要有以下几个原因：

  • 获取和管理第三方模块：npm仓库拥有世界上最大的代码模块集合，涵盖了从Web框架（如Express、Koa）到前端工具（如React、Vue、Angular）、构建工具（如Webpack、Gulp）以及各种实用工具库等几乎所有开发需求。通过npm，您可以轻松地将这些模块引入到您的项目中。
  • 项目依赖管理：npm允许您在项目的package.json文件中定义所有依赖项及其版本。当团队成员克隆项目后，只需运行一个简单的命令（npm install），npm就会自动下载并安装所有必需的依赖，确保开发环境的一致性。
  • 运行项目脚本：package.json文件还允许您定义各种脚本命令，例如启动开发服务器、运行测试、构建生产版本等。通过npm run 命令，您可以方便地执行这些脚本。
  • 开发命令行工具：许多流行的开发工具本身就是npm包，例如ESLint、Prettier、Vite等。通过npm，您可以全局安装这些工具，并在命令行中直接使用它们。
  • 提升开发效率：通过利用现有的大量开源模块，开发者无需重复造轮子，可以将更多精力投入到核心业务逻辑的实现上，从而显著提升开发效率。

三、npm的安装方式有哪些？（核心：随Node.js安装）

npm的安装方式主要有两种，但其中一种是主流且推荐的方式：

  • 随Node.js安装包一同安装（推荐且最常见）：这是最简单、最推荐的方式。Node.js的官方安装包（适用于Windows、macOS）或者通过包管理器（适用于Linux）安装Node.js时，npm会作为捆绑组件自动安装到您的系统中。您无需单独下载或配置npm。
  • 独立安装npm（不推荐，特殊情况除外）：理论上npm可以独立于Node.js进行安装，但这通常不被推荐。因为npm的运行依赖于Node.js，独立安装会增加复杂性，并且可能导致版本不匹配或路径配置问题。除非您有非常特殊的理由（例如管理多个Node.js版本），否则请始终通过安装Node.js来获取npm。

因此，接下来的教程将围绕如何安装Node.js来展开，因为这是获取npm的正确且便捷的方法。

四、如何安装Node.js及附带的npm？（分平台详细教程）

根据您的操作系统，安装Node.js（及npm）的步骤略有不同。我们分别提供Windows、macOS和Linux的详细安装指南。

4.1 访问官方网站下载

无论您使用哪种操作系统，第一步都是访问Node.js的官方网站下载安装包：

官方网站： https://nodejs.org/

进入网站后，您会看到两个主要版本选项：

  • LTS (Long Term Support) 版本：长期支持版本，稳定且经过充分测试，推荐给大多数用户和生产环境。
  • Current 版本：最新功能版本，包含最新的特性，但可能稳定性不如LTS版本，适合尝鲜和测试新功能。

建议您选择LTS版本进行下载，以获得最佳的稳定性和兼容性。

4.2 在Windows系统上安装

  1. 下载安装包：从Node.js官网下载适用于Windows的.msi安装程序（通常会自动识别您的系统位数）。
  2. 运行安装程序：双击下载的.msi文件，启动Node.js安装向导。
  3. 遵循向导步骤：

    • 点击“Next”接受许可协议。
    • 选择安装路径（默认通常是C:\Program Files\nodejs\，您可以根据需要更改）。
    • 在“Custom Setup”步骤中，确保“Node.js runtime”和“npm package manager”都被选中。通常，这些选项是默认选中的，无需手动更改。同时，“Add to PATH”选项也应该被选中，这会为您自动配置系统环境变量，使得Node.js和npm命令可以在任何目录下执行。
    • 点击“Next”，然后点击“Install”开始安装。
    • 安装过程可能需要管理员权限，请允许。
  4. 完成安装：安装完成后，点击“Finish”退出安装向导。

提示：Windows安装程序会自动将Node.js和npm的路径添加到系统的PATH环境变量中。这使得您可以在命令提示符（Command Prompt）或PowerShell中的任何位置直接运行node和npm命令。如果安装后命令无法识别，您可能需要检查环境变量配置或重启电脑。

4.3 在macOS系统上安装

使用官方安装包

  1. 下载安装包：从Node.js官网下载适用于macOS的.pkg安装程序。
  2. 运行安装程序：双击下载的.pkg文件，启动Node.js安装向导。
  3. 遵循向导步骤：

    • 点击“继续”接受许可协议。
    • 选择安装位置（通常是默认的系统路径）。
    • 输入您的macOS密码以允许安装。
    • 安装程序会自动配置路径。
  4. 完成安装：安装完成后，点击“关闭”退出安装向导。

使用Homebrew安装（推荐macOS用户）

Homebrew是macOS上流行的包管理器，使用它安装软件非常方便，并且易于管理更新。如果您尚未安装Homebrew，请先打开终端并执行以下命令安装：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装Homebrew后，即可安装Node.js：

  1. 打开终端：启动“应用程序”->“实用工具”->“终端”。
  2. 执行安装命令：输入以下命令并按回车键。

    brew install node

    Homebrew会自动下载并安装最新LTS版本的Node.js和npm。

4.4 在Linux系统上安装

使用包管理器安装（推荐）

大多数Linux发行版都提供了Node.js和npm的官方包。使用包管理器安装是最简单且推荐的方式。

  • Debian/Ubuntu系统：

    1. 更新包列表：

      sudo apt update

    2. 安装Node.js和npm：

      sudo apt install nodejs npm

    注意：通过apt安装的nodejs包有时可能不是最新版本。如果需要最新版本，可以考虑使用NodeSource提供的PPA（Personal Package Archive）或NVM。

  • CentOS/Fedora系统：

    1. 对于CentOS 7/8，您可能需要先启用EPEL存储库：

      sudo yum install epel-release

    2. 安装Node.js和npm：

      sudo yum install nodejs npm

      (对于较新版本的Fedora，可能使用 sudo dnf install nodejs npm)

使用NVM（Node Version Manager）安装（推荐高级用户及多版本管理）

NVM是一个Node.js版本管理器，允许您在同一台机器上安装和切换多个Node.js版本。这对于需要测试不同Node.js版本的项目非常有用。

  1. 安装NVM：在终端中执行以下curl命令来安装NVM。这会下载并运行NVM安装脚本。

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

    （请注意，v0.39.1是NVM的某个版本号，您可能需要访问NVM的GitHub页面获取最新安装脚本。）

    安装完成后，您可能需要关闭并重新打开终端，或者运行source ~/.bashrc（或~/.zshrc等，取决于您的shell配置）来使NVM命令生效。

  2. 安装Node.js版本：使用NVM安装Node.js（会自动附带相应版本的npm）。

    • 安装最新LTS版本：

      nvm install --lts

    • 安装特定版本（例如18.17.1）：

      nvm install 18.17.1

  3. 使用Node.js版本：安装后，您需要告诉NVM使用哪个Node.js版本。

    • 使用最新LTS版本：

      nvm use --lts

    • 使用特定版本：

      nvm use 18.17.1

五、安装后如何验证npm是否成功？

安装Node.js和npm后，最重要的一步就是验证它们是否已成功安装并且可以在命令行中正常工作。

  1. 打开命令行工具：

    • Windows：按下Win + R，输入cmd并按回车，或在搜索栏输入“PowerShell”打开。
    • macOS/Linux：打开“终端”（Terminal）应用。
  2. 检查Node.js版本：在命令行中输入以下命令并按回车：

    node -v

    如果Node.js安装成功，您应该会看到类似v18.17.1的输出（版本号可能不同）。

  3. 检查npm版本：在命令行中输入以下命令并按回车：

    npm -v

    如果npm安装成功，您应该会看到类似9.6.7的输出（版本号可能不同）。

如果这两个命令都正确显示了版本号，那么恭喜您，Node.js和npm已经成功安装并配置到您的系统中了！

六、如何更新npm版本？

npm会随着Node.js一起发布，但npm自身也可以独立更新。通常建议将npm更新到最新版本，以获取最新的功能、性能改进和安全修复。

在命令行中执行以下命令来更新npm到最新版本：

npm install -g npm@latest

  • -g参数表示全局安装，这样npm工具本身就会被更新。
  • npm@latest表示安装最新稳定版本的npm。

更新完成后，再次运行npm -v来验证npm是否已成功更新到最新版本。

七、npm安装包的基本操作示例

一旦npm安装成功，您就可以开始使用它来管理您的项目依赖了。以下是一些最常用的npm命令：

  • 初始化项目：

    在一个新的项目目录下，运行此命令可以创建一个package.json文件，它是npm项目的核心配置文件。

    npm init

    它会引导您填写项目名称、版本、描述、入口文件等信息。如果您想快速创建并使用默认值，可以使用npm init -y。

  • 安装依赖包：

    在项目目录下，安装项目所需的第三方模块。

    npm install

    例如，安装流行的Web框架Express：npm install express。这会将express包安装到您项目目录下的node_modules文件夹中，并将其信息添加到package.json的dependencies字段。

    如果需要安装开发依赖（仅在开发过程中需要，生产环境不需要，例如测试工具、构建工具），使用--save-dev或-D参数：

    npm install --save-dev 或 npm install -D

  • 全局安装包：

    有些工具是命令行工具，您希望在系统的任何位置都能使用它们，这时需要全局安装。

    npm install -g

    例如，安装Vite命令行工具：npm install -g vite。

  • 卸载包：

    从项目中移除不再需要的依赖包。

    npm uninstall

  • 安装所有依赖：

    当您获得一个新项目（例如从Git仓库克隆）时，项目目录下通常会有package.json文件。运行此命令可以安装package.json中列出的所有依赖。

    npm install

八、安装npm时可能遇到的常见问题及解决方案

在安装Node.js和npm的过程中，您可能会遇到一些常见问题。以下是一些问题及其对应的解决方案。

8.1 ‘node’或‘npm’不是内部或外部命令

问题描述：在命令行中输入node -v或npm -v后，系统提示“’node’ 不是内部或外部命令，也不是可运行的程序或批处理文件。”

原因：这通常是因为Node.js和npm的安装路径没有正确添加到系统的PATH环境变量中，或者环境变量没有及时生效。

解决方案：

  1. 重启命令行工具：有时只需要关闭当前命令行窗口，然后重新打开一个新窗口即可。
  2. 重启电脑：在Windows系统上，某些环境变量的更改可能需要重启电脑才能完全生效。
  3. 手动添加环境变量（Windows）：

    • 右键点击“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
    • 在“系统变量”下找到“Path”变量，双击打开。
    • 点击“新建”，然后添加您的Node.js安装路径（例如：C:\Program Files\nodejs\）。
    • 一路点击“确定”保存更改，然后重新打开命令行工具。
  4. 检查安装程序选项：确保在Node.js安装过程中，“Add to PATH”选项是被选中的。如果不是，可以考虑重新运行安装程序。

8.2 安装权限问题（EACCES error on macOS/Linux）

问题描述：在macOS或Linux系统上执行npm install -g命令时，可能会遇到EACCES权限错误，提示无法写入全局安装目录。

原因：这是因为npm默认的全局安装目录需要管理员权限才能写入，而您当前的用户没有这些权限。

解决方案：

  1. 不推荐但临时的方案：使用sudo：

    sudo npm install -g

    虽然这可以解决权限问题，但不推荐长期使用，因为它可能导致所有全局安装的包都由root用户拥有，从而引发后续的权限问题。

  2. 推荐方案：修改npm默认全局安装路径：

    将npm的全局安装目录更改为用户自己的主目录下的一个子目录，这样就不再需要管理员权限。

    • 创建新的全局安装目录（如果不存在）：

      mkdir ~/.npm-global

    • 配置npm使用这个新目录：

      npm config set prefix '~/.npm-global'

    • 将这个目录添加到PATH环境变量中：
      • 打开您的shell配置文件（例如~/.bashrc, ~/.bash_profile, ~/.zshrc）。
      • 在文件末尾添加以下行：

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

      • 保存文件并关闭。
    • 使环境变量生效：

      source ~/.bashrc (或您编辑的相应文件，如source ~/.zshrc)

    完成这些步骤后，您可以不使用sudo来全局安装npm包了。

8.3 网络连接问题或下载缓慢

问题描述：在使用npm安装包时，出现网络错误、下载超时或者下载速度非常慢。

原因：npm的官方源位于国外，由于网络连接问题或防火墙限制，国内用户访问可能会遇到困难。

解决方案：

  1. 配置npm镜像源：使用国内的npm镜像源可以显著提高下载速度和稳定性。淘宝NPM镜像（现已更名为npmmirror）是一个很好的选择。

    • 临时使用：

      npm install --registry=https://registry.npmmirror.com

    • 永久配置：

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

    您可以通过npm config get registry命令来验证镜像是否配置成功。

  2. 使用VPN或代理：如果仍然遇到问题，尝试使用VPN或配置代理服务器。

8.4 npm缓存问题

问题描述：有时npm的缓存可能会导致安装问题、版本冲突或不一致的行为。

原因：npm会缓存下载的包，以加快后续安装速度。但如果缓存损坏或过时，可能会引起问题。

解决方案：

  1. 清理npm缓存：

    npm cache clean --force

    这个命令会清空npm的本地缓存。在执行此命令后，再次尝试安装包。

九、如何卸载Node.js和npm？

如果您因为某种原因需要彻底移除Node.js和npm，可以按照以下步骤操作：

9.1 Windows系统

  1. 使用控制面板卸载：

    • 打开“控制面板” -> “程序” -> “程序和功能”。
    • 在程序列表中找到“Node.js”。
    • 右键点击“Node.js”并选择“卸载”。
    • 遵循卸载向导的指示完成卸载。
  2. 手动清理残余文件（可选）：

    • 删除Node.js的安装目录（例如：C:\Program Files\nodejs\）。
    • 删除npm的全局安装目录和缓存目录。npm的全局安装目录通常在C:\Users\\AppData\Roaming\npm，npm的缓存目录通常在C:\Users\\AppData\Roaming\npm-cache。
    • 检查并移除PATH环境变量中与Node.js相关的条目。

9.2 macOS系统

如果使用官方安装包（.pkg）安装：

macOS没有像Windows那样直接的“卸载程序”功能。您需要手动删除相关文件。

  1. 打开终端。
  2. 删除Node.js和npm相关文件：执行以下命令来删除通常由.pkg安装包创建的文件和目录。

    sudo rm -rf /usr/local/lib/node_modules

    sudo rm /usr/local/bin/node

    sudo rm /usr/local/bin/npm

    sudo rm /usr/local/bin/npx

    sudo rm -rf /usr/local/include/node

    sudo rm -rf ~/.npm

    sudo rm -rf ~/.npmrc

    sudo rm -rf ~/.npm-global (如果您修改过全局安装路径)

    如果还有其他Node.js版本管理器（如nvm）安装的Node.js，也需要通过相应工具卸载。

如果使用Homebrew安装：

  1. 打开终端。
  2. 卸载Node.js：

    brew uninstall node

  3. 清理相关文件（可选）：Homebrew通常会很好地清理，但您也可以手动检查并删除Homebrew存储Node.js相关文件的路径。

9.3 Linux系统

如果使用包管理器（apt/yum/dnf）安装：

  1. 打开终端。
  2. 卸载Node.js和npm：

    • Debian/Ubuntu：

      sudo apt remove nodejs npm

    • CentOS/Fedora：

      sudo yum remove nodejs npm

      (或 sudo dnf remove nodejs npm)

  3. 清理残余文件（可选）：

    sudo apt purge nodejs (或 sudo yum autoremove nodejs)

如果使用NVM安装：

  1. 打开终端。
  2. 卸载特定Node.js版本：

    nvm uninstall (例如：nvm uninstall 18.17.1)

    如果这是您唯一的Node.js版本，或者您想完全移除NVM，请继续下一步。

  3. 完全移除NVM（如果需要）：

    • 首先，从您的shell配置文件（~/.bashrc, ~/.zshrc等）中删除所有NVM相关的行。这些行通常包括export NVM_DIR、[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"等。
    • 然后，删除NVM的安装目录：

      rm -rf "$NVM_DIR"

    • 最后，关闭并重新打开终端。

通过遵循上述详细步骤，您应该能够顺利地安装、配置和管理Node.js以及其强大的包管理器npm。现在，您已准备好开始您的Node.js开发之旅！

npm怎么安装