首页
/ 正文

Node.js 安装配置（一文讲透）

更新时间: 2025-04-02 11:21:05

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;

《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前，星球内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习，欢迎点击围观

前言

在现代 web 开发领域，Node.js 凭借其高效的事件驱动架构和丰富的生态，成为前后端全栈开发的重要工具。无论是构建实时聊天应用、API 服务，还是搭建静态网站，Node.js 都能提供轻量且灵活的解决方案。然而，对于编程初学者或刚接触服务端开发的开发者来说，Node.js 安装配置的过程可能会显得有些复杂。本文将通过分步讲解、案例演示和常见问题解答，帮助读者快速掌握 Node.js 的安装与环境配置，为后续开发奠定坚实基础。

一、安装 Node.js 的核心价值

在深入安装步骤之前，我们需要理解为什么 Node.js 的安装配置如此重要：

基础环境搭建：Node.js 是运行 JavaScript 的服务器端运行时环境，安装它相当于为开发工作提供了“数字画布”，开发者可以在其上编写和执行代码。
模块化开发：Node.js 的包管理工具 npm（Node Package Manager）提供了超过 100 万个开源模块，安装配置后即可直接调用这些模块，大幅提高开发效率。
跨平台兼容性：Node.js 支持 Windows、macOS、Linux 等主流操作系统，确保代码在不同环境中的无缝运行。

可以将 Node.js 比作一家快递公司：安装配置相当于搭建物流网络，只有网络稳定运行后，才能高效地“运输”（执行）代码包裹（JavaScript 代码）。

二、Node.js 安装步骤（分操作系统详解）

1. Windows 系统安装

步骤 1：下载安装包

访问 Node.js 官网，选择 LTS（Long-Term Support）版本（如 v20.x.x），下载 Windows 安装程序（.exe 文件）。

步骤 2：执行安装向导

双击下载的安装包，勾选 Add to PATH（自动配置环境变量）选项，点击 Install。
安装完成后，重启命令提示符（CMD）或 PowerShell，执行以下命令验证安装：
```
node -v  
npm -v  
```
若显示版本号（如 v20.10.0 和 10.2.5），则安装成功。

步骤 3：手动配置环境变量（可选）

若未勾选 Add to PATH，需手动添加 Node.js 路径到系统环境变量：

打开 控制面板 > 系统和安全 > 系统 > 高级系统设置。
点击 环境变量，在 系统变量 中找到 Path，点击编辑。
新增 C:\Program Files\nodejs（默认安装路径）。

2. macOS 系统安装

方法 1：通过 Homebrew 安装

Homebrew 是 macOS 的包管理工具，安装步骤如下：

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

安装完成后，执行 node -v 和 npm -v 验证版本。

方法 2：直接下载安装包

与 Windows 类似，从官网下载 .pkg 文件并执行安装，勾选 Install npm 和 Install for all users 选项。

3. Linux 系统安装（以 Ubuntu 为例）

步骤 1：更新软件源

sudo apt update

步骤 2：安装 Node.js

sudo apt install nodejs  
sudo apt install npm

步骤 3：验证安装

node -v  
npm -v

三、环境配置与扩展

1. 配置 npm 环境

安装完成后，可通过以下命令优化 npm 的使用体验：

设置镜像源（加速包下载）：

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

全局安装常用工具：

npm install -g nodemon  # 实时监控代码变化并重启服务  
npm install -g eslint   # JavaScript 代码规范检查

2. 初始化项目结构

使用 npm init 命令快速生成项目配置文件：

mkdir my-node-app  
cd my-node-app  
npm init -y  # 自动生成默认的 package.json

此时，项目目录中将包含 package.json 文件，用于管理依赖和脚本命令。

四、实战案例：创建第一个 Node.js 项目

案例 1：Hello World 服务

编写代码：在项目根目录下创建 server.js 文件，输入以下内容：

const http = require('http');  
const port = 3000;  

const server = http.createServer((req, res) => {  
  res.statusCode = 200;  
  res.setHeader('Content-Type', 'text/plain');  
  res.end('Hello World from Node.js!\n');  
});  

server.listen(port, () => {  
  console.log(`Server running at http://localhost:${port}/`);  
});

运行服务：
```
node server.js  
```
打开浏览器访问 http://localhost:3000，即可看到输出结果。

案例 2：使用 Express 框架

Express 是 Node.js 的流行框架，可简化路由和中间件配置。安装步骤如下：

安装 Express：
```
npm install express  
```

创建 app.js 文件：

const express = require('express');  
const app = express();  
const port = 3000;  

app.get('/', (req, res) => {  
  res.send('Welcome to Express!');  
});  

app.listen(port, () => {  
  console.log(`Express server running on port ${port}`);  
});

运行服务：
```
node app.js  
```
访问 http://localhost:3000 即可看到 Express 的欢迎信息。

五、常见问题与解决方案

问题 1：安装后命令不可用

现象：执行 node 或 npm 命令时提示“未找到命令”。
解决方法：

检查环境变量配置是否正确，确保 Node.js 的安装路径（如 C:\Program Files\nodejs）已添加到系统 Path 中。
重新安装 Node.js 时勾选 Add to PATH 选项。

问题 2：npm 安装包速度慢

解决方法：

使用国内镜像源（如淘宝镜像）：

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

临时指定镜像源安装包：

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

问题 3：权限不足（Linux 系统）

现象：执行 npm install -g 时提示权限错误。
解决方法：

使用 sudo 提升权限：
```
sudo npm install -g package-name  
```

或者配置 npm 使用无 root 权限的全局路径：

mkdir ~/.npm-global  
npm config set prefix '~/.npm-global'  
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc  
source ~/.bashrc

六、进阶配置与最佳实践

1. 版本管理：nvm（Node Version Manager）

nvm 允许在同一台机器上管理多个 Node.js 版本，适合需要兼容不同项目需求的开发者。

安装 nvm（Linux/macOS）：

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

使用 nvm 安装 Node.js：

nvm install --lts  
nvm use --lts

2. 代码规范与测试

ESLint 配置：在项目根目录创建 .eslintrc.js 文件，定义代码规范。
单元测试：使用 Mocha 或 Jest 框架编写测试用例，并通过 npm test 脚本执行。

结论

通过本文的讲解，读者应已掌握 Node.js 的安装配置方法、环境优化技巧，以及实际项目的搭建流程。Node.js 的核心优势在于其异步非阻塞特性和庞大的生态支持，而扎实的环境配置是发挥这些优势的前提。建议读者按照步骤逐步实践，从简单的 HTTP 服务开始，逐步尝试 Express、Koa 等框架，最终实现复杂项目的开发。记住，Node.js 安装配置只是起点，真正的价值在于通过它构建出高效、可靠的 web 应用。

如需进一步学习，可参考官方文档或参与开源项目实践。祝你在 Node.js 的开发旅程中收获满满！