Node.js 入门实战:从安装到写出第一个 Web 服务
很多前端同学写了多年 JavaScript,却从没让它离开过浏览器。Node.js 让 JavaScript 第一次可以跑在服务器上:它基于 Chrome 的 V8 引擎,采用事件驱动、非阻塞 I/O 的模型处理请求,一台普通的电脑就能跑起一个 Web 服务。本文用最短的路径,带你从安装走到第一个能用的 Web 服务。
一、Node.js 是什么
一句话概括:Node.js 是一个能让 JavaScript 运行在服务器端的运行环境。它把 V8 引擎和系统能力封装在一起,让 JavaScript 可以读写文件、访问网络、操作进程。
和传统服务端语言相比,Node.js 有两个鲜明特点。第一,单线程事件循环:一个线程配合事件循环处理大量并发连接,等待数据库或文件读写时不会白白占用线程,适合 I/O 密集型场景。第二,前后端同一种语言:前端同学不用再学一门新语言就能写接口、做工具、搭服务,学习成本低,上手快。
当然它也有短板:CPU 密集型计算不适合放在主线程里做,比如大图片处理、复杂加密运算,这类任务要交给子进程或专门的服务去做。
二、安装与验证
去系统对应的安装包官网下载长期支持版(LTS),一路下一步安装即可,安装程序会顺带装好 npm 包管理器。装完后打开终端,执行下面两条命令:
node -v
npm -v
两条命令都能打印出版本号,就说明安装成功。建议新手直接用 LTS 版本,它更稳定,遇到问题时网上的资料也最多。
三、第一个程序:Hello Node
新建一个 hello.js 文件,只写一行代码:
console.log('Hello, Node.js!');
在终端里执行 node hello.js,屏幕上出现 Hello, Node.js!,第一个 Node.js 程序就跑起来了。这个过程没有浏览器、没有页面刷新,只有一次命令执行,这就是服务端开发最常见的运行方式。
四、写出第一个 Web 服务
只用内置的 http 模块,不需要装任何第三方包,就能写一个 Web 服务:
const http = require('http');
const server = http.createServer((req, res) => {
res.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' });
res.end('你好,Node.js Web 服务!');
});
server.listen(3000, () => {
console.log('服务已启动,请访问 3000 端口');
});
执行 node server.js 后打开浏览器访问本机的 3000 端口,就能看到返回的文字。createServer 接收一个回调函数,每来一个请求就执行一次;res.writeHead 设置状态码和响应头,res.end 把响应内容发回给浏览器;listen 让服务在指定端口上等待请求。
试着改一改:让服务根据请求路径返回不同内容,例如访问根路径返回欢迎语,访问时间路径返回当前时间。改完保存,重启服务就能看到效果。
五、理解异步:不要阻塞事件循环
Node.js 的核心是异步。读文件、查数据库、发网络请求都不会立刻返回结果,而是通过回调函数、Promise 或 async/await 在完成时通知你。写代码时要养成习惯:凡是耗时操作都用异步写法,不要在请求处理里做同步等待。
一个常见的坑是在接口里用同步方法读大文件,整个服务会被卡住,所有请求都要排队。正确的做法是用异步接口,或者把耗时计算放到子进程。记住一条原则:事件循环是单车道,任何一次长时间占用都会堵住后面的所有请求。
六、包管理与模块
Node.js 自带 npm,装包只需要一条命令,例如 npm install express。项目里会出现 package.json 文件,它记录了项目名、版本和依赖,别人拿到这个文件执行 npm install 就能装好同样的依赖。
代码组织上推荐用模块化:把路由、工具函数、配置拆成不同文件,用 require 引入,需要时再用 module.exports 导出。这样项目变大之后依然好维护。
七、常见问题与避坑
第一,端口被占用:启动时报错地址已被使用,先检查是不是之前启动的服务没关掉,换个端口再试。第二,改完代码没生效:Node.js 不会自动重载,改完要重新执行命令,开发时可以用 nodemon 这类工具自动重启。第三,依赖装不上:先确认网络是否正常,再检查 npm 的源配置,不要反复删除重装。
八、小结
今天我们走通了 Node.js 的完整入门路径:理解它是什么、装好 LTS 版本、写出第一个程序、用内置模块搭起第一个 Web 服务,并理解了异步与事件循环的基本原则。下一步可以试着给服务加上路由和 JSON 接口,再学一个 Express 这样的框架,把静态页面和接口结合起来,做一个真正能用的小应用。入门之后多动手,遇到问题先看报错信息,再查官方文档,这是进步最快的方式。
- 点赞
- 收藏
- 关注作者
评论(0)