Node.js 本地 Web 开发指南
使用 Node.js 在 localhost 上运行 Express、Fastify 等 Web 应用，常见端口 3000、8080。
Node.js 内置 HTTP 模块，配合 Express、Fastify、Koa 等框架可快速搭建本地 Web 服务。现代前端全栈与 API 开发大多在 localhost 上完成调试。
常见 localhost 地址
| 框架/工具 | 默认地址 |
|---|---|
| Express / 通用 | http://localhost:3000 |
| Next.js | http://localhost:3000 |
| Vite 开发服务器 | http://localhost:5173 |
| Create React App | http://localhost:3000 |
端口可在代码或环境变量中自定义，例如 process.env.PORT || 8080。
最小 Express 示例
const express = require('express');
const app = express();
app.get('/', (req, res) => {
res.send('Hello from localhost');
});
app.listen(3000, () => {
console.log('http://localhost:3000');
});运行 node app.js 后访问 **http://localhost:3000**。
启动方式
npm install
npm run dev # 多数项目
node server.js # 直接运行
npx vite # 前端 dev server监听所有接口
开发时若需手机或局域网访问，监听 0.0.0.0：
app.listen(3000, '0.0.0.0');本机仍可用 http://localhost:3000 访问。
常见问题
EADDRINUSE 端口被占用
更换端口或结束占用进程：lsof -i :3000（macOS/Linux）。
localhost 拒绝连接
确认服务已启动，检查防火墙与监听地址。
CORS 跨域
前端 dev server（5173）请求后端（3000）时，需在后端配置 CORS 或使用代理。
小结
Node.js 本地开发通常使用 http://localhost:3000 等端口，无需单独安装 Apache/Nginx，框架自带开发服务器即可。