nodejs安装保姆级教程

Node.js 安装与环境配置教程

1. Node.js 简介

Node.js 是一个基于 JavaScript 的跨平台运行环境，可以在 Windows、Linux、macOS 等操作系统中运行 JavaScript。

常见用途：

• Web 后端开发
• Vue / React / Vite 前端工程
• REST API
• WebSocket
• 命令行工具
• 自动化脚本
• Electron 桌面应用
• npm 工具链

Node.js 安装完成后通常会同时安装：

Node.js
├── node    JavaScript 运行环境
└── npm     Node.js 包管理器

常用检查命令：

node -v
npm -v

---

2. Node.js 版本选择

Node.js 主要分为：

LTS      长期支持版本
Current  当前最新版本

普通开发、生产环境建议选择：

LTS

如果项目明确要求某个 Node.js 版本，则按照项目要求安装。

---

3. Windows 安装 Node.js

3.1 下载 Node.js

进入 Node.js 官方网站：

https://nodejs.org/en/download

选择：

LTS

Windows 普通 Intel / AMD 电脑一般下载：

Windows Installer (.msi)
x64

---

3.2 安装

运行下载的：

node-xxx-x64.msi

按照安装程序依次点击：

Next

同意许可协议。

默认安装目录通常为：

C:\Program Files\nodejs\

组件保持默认配置即可，确保包含：

Node.js runtime
npm package manager
Add to PATH

然后执行：

Install

安装完成后点击：

Finish

---

4. 检查 Node.js 是否安装成功

重新打开：

CMD
PowerShell
Windows Terminal

执行：

node -v

例如：

v24.x.x

继续执行：

npm -v

例如：

11.x.x

如果均能正常显示版本号，则安装成功。

---

5. 配置 npm 国内镜像源

5.1 查看当前 npm 源

npm config get registry

默认通常为：

https://registry.npmjs.org/

---

5.2 切换 npmmirror 镜像源

执行：

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

检查：

npm config get registry

正常情况下输出：

https://registry.npmmirror.com/

---

5.3 恢复 npm 官方源

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

检查：

npm config get registry

---

5.4 临时指定镜像源

如果只想让某一次安装使用国内镜像：

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

不会修改默认 npm 配置。

---

6. 使用 .npmrc 配置 npm 源

npm 也可以通过 .npmrc 文件配置。

6.1 用户级配置

Windows：

C:\Users\用户名\.npmrc

Linux / macOS：

~/.npmrc

写入：

registry=https://registry.npmmirror.com

---

6.2 项目级配置

在项目根目录创建：

.npmrc

例如：

my-project/
├── src/
├── package.json
├── package-lock.json
└── .npmrc

写入：

registry=https://registry.npmmirror.com

此配置只影响当前项目。

---

7. macOS / Linux 使用 nvm 安装 Node.js

macOS 和 Linux 推荐使用 nvm 管理 Node.js。

nvm：

[Node Version Manager](https://github.com/nvm-sh/nvm)

可以在同一台电脑上安装并切换多个 Node.js 版本。

例如：

Node.js 20
Node.js 22
Node.js 24

---

8. 安装 nvm

项目地址：

https://github.com/nvm-sh/nvm

按照项目 README 中提供的安装命令进行安装。

安装完成后重新打开终端。

检查：

command -v nvm

正常情况下输出：

nvm

如果没有生效，可以重新加载 Shell 配置。

Bash：

source ~/.bashrc

Zsh：

source ~/.zshrc

---

9. 使用 nvm 安装 Node.js

安装最新版本：

nvm install node

安装指定主版本：

nvm install 24

切换版本：

nvm use 24

查看已经安装的版本：

nvm ls

查看可安装版本：

nvm ls-remote

设置默认版本：

nvm alias default 24

检查：

node -v
npm -v

---

10. 创建第一个 Node.js 程序

创建项目目录：

mkdir node-demo

进入目录：

cd node-demo

创建：

app.js

写入：

console.log("Hello Node.js!");

运行：

node app.js

输出：

Hello Node.js!

---

11. 初始化 Node.js 项目

执行：

npm init

如果使用默认配置：

npm init -y

此时会生成：

package.json

目录结构：

node-demo/
├── app.js
└── package.json

---

12. 安装 npm 依赖

例如安装 Axios：

npm install axios

安装完成后：

node-demo/
├── node_modules/
├── app.js
├── package.json
└── package-lock.json

其中：

node_modules/

保存项目依赖。

package.json

保存项目配置和依赖声明。

package-lock.json

记录实际安装的依赖版本。

---

13. 配置 .gitignore

Node.js 项目通常不提交：

node_modules/

在项目根目录创建：

.gitignore

写入：

node_modules/

常见 Node.js .gitignore：

node_modules/
dist/
.env
*.log
.DS_Store

---

14. 常用 npm 命令

安装全部依赖

npm install

简写：

npm i

---

安装依赖

npm install axios

简写：

npm i axios

---

安装开发依赖

npm install eslint --save-dev

简写：

npm i eslint -D

---

卸载依赖

npm uninstall axios

---

查看依赖

npm list

---

查看全局安装的软件包

npm list -g --depth=0

---

更新依赖

npm update

---

运行项目脚本

npm run dev

例如：

npm run build

npm run start

---

15. npm、node、npx 的区别

Node.js
   │
   ├── node
   │    └── 运行 JavaScript
   │
   ├── npm
   │    └── 安装和管理依赖
   │
   └── npx
        └── 执行 npm 软件包提供的命令

例如：

node app.js

运行 JavaScript 文件。

npm install axios

安装依赖。

npx vite

执行 Vite。

---

16. 查看 npm 配置

查看全部 npm 配置：

npm config list

查看 Registry：

npm config get registry

查看代理：

npm config get proxy

npm config get https-proxy

---

17. npm 配置代理

如果需要通过 HTTP 代理访问网络：

npm config set proxy http://127.0.0.1:7890

HTTPS：

npm config set https-proxy http://127.0.0.1:7890

检查：

npm config get proxy

npm config get https-proxy

删除代理：

npm config delete proxy
npm config delete https-proxy

---

18. 清理 npm 缓存

查看缓存目录：

npm config get cache

检查缓存：

npm cache verify

强制清理：

npm cache clean --force

一般情况下不需要主动清理 npm 缓存。

---

19. 常见问题

19.1 node 不是内部或外部命令

如果 Windows 提示：

'node' 不是内部或外部命令

重新打开终端后执行：

node -v

仍然无效时，检查环境变量：

PATH

是否包含：

C:\Program Files\nodejs\

---

19.2 npm 不是内部或外部命令

检查：

node -v

如果 Node.js 正常但 npm 无法使用，可以重新运行 Node.js 安装程序，并确认：

npm package manager

已经安装。

---

19.3 npm 下载速度慢

检查当前源：

npm config get registry

切换国内源：

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

---

19.4 npm 安装依赖超时

可以检查：

npm config get registry
npm config get proxy
npm config get https-proxy

如果配置了错误代理：

npm config delete proxy
npm config delete https-proxy

然后重新执行：

npm install

---

19.5 nvm 安装后无法识别

如果出现：

nvm: command not found

Bash：

source ~/.bashrc

Zsh：

source ~/.zshrc

然后：

command -v nvm

---

20. 最终环境检查

执行：

node -v
npm -v
npm config get registry

如果使用 nvm：

nvm --version

国内镜像配置完成后，输出类似：

v24.x.x
11.x.x
https://registry.npmmirror.com/

说明 Node.js 开发环境已经配置完成。

---

21. 推荐环境

日常开发推荐：

Node.js LTS
+
npm
+
Git
+
VS Code

Linux / macOS 推荐：

nvm
+
Node.js LTS
+
npm
+
Git
+
VS Code

常用初始化流程：

node -v
npm -v

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

mkdir my-project
cd my-project

npm init -y

Node.js 环境安装与基础配置完成。