环境准备(安装Node.js)
-
下载安装包
访问Node.js官网下载LTS版本(长期支持版),避免使用Beta版。 -
验证安装
打开命令窗口(Windows:Win+R
→ 输入cmd
;Mac/Linux:打开Terminal
),执行:node -v # 显示版本号(如v18.16.0) npm -v # 显示npm版本
若提示命令不存在,需将Node添加到系统环境变量(安装时勾选”Add to PATH”)。
启动Node服务的完整流程
步骤1:创建Node脚本文件
新建server.js
文件,写入基础HTTP服务器代码:
const http = require('http'); const port = 3000; // 端口号 const server = http.createServer((req, res) => { res.statusCode = 200; res.setHeader('Content-Type', 'text/plain'); res.end('Node服务已成功启动!'); }); server.listen(port, () => { console.log(`服务运行中:http://localhost:${port}/`); });
步骤2:通过命令窗口启动服务
-
进入脚本所在目录(关键步骤)
cd /path/to/your/project # 替换为实际路径
-
执行启动命令
node server.js
成功提示:控制台显示
服务运行中:http://localhost:3000/
步骤3:验证服务运行
- 浏览器访问
http://localhost:3000
,显示”Node服务已成功启动!” - 或使用
curl
测试:curl http://localhost:3000
步骤4:停止服务
在命令窗口按Ctrl + C
(两次)强制退出进程。
常见问题解决方案
-
端口冲突(Error: listen EADDRINUSE)
-
修改脚本中的
port
值(如8080
) -
查找占用进程并终止:
# Windows netstat -ano | findstr :3000 taskkill /PID <进程ID> /F # Mac/Linux lsof -i :3000 kill -9 <进程ID>
-
-
文件路径错误
- 确保命令窗口工作目录正确(使用
cd
命令切换) - 检查脚本文件名是否匹配(区分大小写)
- 确保命令窗口工作目录正确(使用
-
权限不足(Linux/Mac)
对1024以下端口需sudo
提权:sudo node server.js # 谨慎使用
安全建议:改用1024以上端口,避免提权风险。
-
代码语法错误
启动前用node --check server.js
验证语法,错误会提示行号。
生产环境最佳实践
-
进程管理
使用pm2
守护进程,崩溃时自动重启:npm install pm2 -g # 安装 pm2 start server.js --name "my-node-app" pm2 save # 保存进程列表
-
环境变量配置
通过.env
文件管理敏感信息(端口、API密钥):npm install dotenv # 安装依赖
在脚本开头添加:
require('dotenv').config(); const port = process.env.PORT || 3000; # 优先使用环境变量
-
日志记录
- 使用
winston
或morgan
记录访问日志 pm2
内置日志:pm2 logs my-node-app
- 使用
通过命令窗口启动Node服务是开发者的核心技能,重点在于:
- 确保Node.js环境正确安装
- 掌握
cd
切换目录与node
执行命令 - 理解端口冲突的排查方法
- 生产环境使用进程管理工具(如
pm2
)
遵循官方文档和社区最佳实践可保障服务稳定性,遇到复杂问题时,优先查阅:
- Node.js官方文档
- npm包安全审计指南
引用说明:本文操作指南基于Node.js v18 LTS官方文档及开发者社区验证方案,安全建议参考OWASP应用安全标准。
原创文章,发布者:酷番叔,转转请注明出处:https://cloud.kd.cn/ask/6164.html