Node.js和npm本地安装详细教程（全系统适配）

Node.js和npm本地安装详细教程（全系统适配）

说明：npm（Node Package Manager） 是Node.js的自带包管理工具，安装Node.js后会自动安装对应版本的npm，无需单独下载。本教程适配Windows、Mac、Linux 三大主流系统，步骤详细且标注关键注意事项，新手可直接跟随操作，全程使用官方渠道，安全无第三方风险。

一、前置准备

1. 1. 设备要求 ：Windows 7及以上、Mac OS X 10.10及以上、Linux（Ubuntu 16.04+、CentOS 7+等），确保设备联网且有足够存储空间（至少100MB）。
2. 2. 下载渠道：仅推荐Node.js官方网站下载，避免第三方平台（防止捆绑软件、版本异常），官方地址：https://nodejs.org/zh-cn/
3. 3. 版本选择：
4. 4. LTS版本（推荐新手）：长期支持版，稳定性高，适配绝大多数项目，标注"LTS"（如v20.x.x）；
5. 5. Current版本：最新版本，包含新特性，但可能存在兼容性问题，适合有经验的开发者。

二、Windows系统安装步骤（最常用）

步骤1：下载Node.js安装包

1. 1. 打开官方网站（https://nodejs.org/zh-cn/），点击"LTS版本"下方的"下载"按钮（默认适配Windows 64位系统）；
2. 2. 若为32位系统，点击页面下方"其他下载"，选择对应32位安装包（标注"x86"）；
3. 3. 下载完成后，找到安装包（默认保存在"下载"文件夹），双击打开。

步骤2：安装Node.js（核心步骤）

1. 1. 打开安装包后，弹出安装向导，点击"Next"（下一步）；
2. 2. 勾选"我接受许可协议中的条款"，点击"Next"；
3. 3. 选择安装路径（建议默认路径 ，如C:\Program Files\nodejs，若需修改，避免中文路径、空格路径，防止后续报错），点击"Next"；
4. 4. 勾选"Add to PATH"（关键步骤，自动配置环境变量，无需手动操作），点击"Next"；
5. 5. 无需勾选额外组件（默认即可），点击"Next"；
6. 6. 点击"Install"（安装），等待1-3分钟，安装完成后点击"Finish"。

步骤3：验证安装是否成功

1. 1. 按下Win+R，输入cmd，打开命令提示符（CMD）；
2. 2. 输入命令 node -v（注意空格），按下回车，若显示Node.js版本号（如v20.10.0），说明Node.js安装成功；
3. 3. 输入命令 npm -v，按下回车，若显示npm版本号（如10.2.3），说明npm自动安装成功。

三、Mac系统安装步骤

方法1：官方安装包安装（推荐新手）

1. 1. 打开Node.js官方网站，点击"LTS版本"下方的"下载"按钮（默认适配Mac OS X 64位，支持Intel芯片和M1/M2芯片）；
2. 2. 下载完成后，双击.dmg安装包，弹出安装窗口；
3. 3. 将Node.js图标拖拽到"Applications"（应用程序）文件夹中，等待复制完成（1-2分钟）；
4. 4. 打开"终端"（Finder→应用程序→实用工具→终端）；
5. 5. 输入命令 node -v 和 npm -v，若均显示版本号（如v20.10.0、10.2.3），说明安装成功。

方法2：Homebrew安装（适合有Homebrew的用户）

1. 1. 打开终端，输入命令 brew install node，按下回车；
2. 2. 等待自动下载、安装（依赖网络，时间视网速而定）；
3. 3. 安装完成后，输入node -v 和 npm -v，验证是否成功（显示对应版本号即为成功）。

四、Linux系统安装步骤（以Ubuntu为例）

方法1：apt-get命令安装（简单便捷）

1. 1. 打开终端（Ctrl+Alt+T）；
2. 2. 输入命令 sudo apt update，更新软件包列表（需要输入管理员密码，输入时密码不显示，正常输入即可）；
3. 3. 输入命令 sudo apt install nodejs npm，按下回车，等待安装完成；
4. 4. 安装完成后，输入 node -v 和 npm -v，验证是否成功（显示对应版本号即为成功）。

方法2：官方源码安装（适合需要指定版本的用户）

1. 1. 打开终端，输入命令 wget https://nodejs.org/dist/v20.10.0/node-v20.10.0-linux-x64.tar.xz（替换版本号为需要的LTS版本）；
2. 2. 解压压缩包：tar -xvf node-v20.10.0-linux-x64.tar.xz；
3. 3. 移动解压后的文件夹：sudo mv node-v20.10.0-linux-x64 /usr/local/nodejs；
4. 4. 配置环境变量：sudo ln -s /usr/local/nodejs/bin/node /usr/bin/node 和 sudo ln -s /usr/local/nodejs/bin/npm /usr/bin/npm；
5. 5. 输入 node -v 和 npm -v，验证是否成功（显示对应版本号即为成功）。

五、常见问题及解决办法（重点）

1. 1. 问题1：CMD/终端输入node -v 显示"不是内部或外部命令"
2. 2. 原因：环境变量未配置成功（Windows系统未勾选"Add to PATH"，或手动修改路径后未更新环境变量）；
3. 3. 解决 ：Windows系统→右键此电脑→属性→高级系统设置→环境变量→在"系统变量"中找到Path→编辑→添加Node.js安装路径（如C:\Program Files\nodejs）→确定→重启CMD即可。
4. 4. 问题2：npm安装包报错"permission denied"（权限不足）
5. 5. 原因：没有管理员权限，无法修改系统目录；
6. 6. 解决 ：Windows系统以"管理员身份"打开CMD；Mac/Linux系统在命令前加sudo（如sudo npm install xxx），输入管理员密码后即可执行。 （注：文档部分内容可能由 AI 生成）