从零开始学习Node.js：一个全栈工程师的成长记录
我第一次接触 Node.js 是在三年前，当时公司让我负责重构一个老的后台管理系统。前端是 Vue.js 写的，但后端还在用 PHP + Apache 的架构，响应慢、维护成本高，还经常出错。领导希望我们能转向前后端分离的技术栈，于是我们决定尝试用 Node.js 来搭建新的服务层。
作为一个刚从 Java 转到 JavaScript 全栈方向的开发者，刚开始那段时间真的挺痛苦的。异步编程的思想跟传统的阻塞式编程差别很大，再加上对 npm、模块系统、Express 框架这些都不是很熟悉，踩了不少坑。不过也正是这段经历，让我深刻理解了 Node.js 的魅力与挑战。
今天我想把我在项目初期的学习和实践过程分享出来，希望能帮到正在学习 Node.js 的你。
初识 Node.js：为什么选择它？
Node.js 的最大优势在于“非阻塞 I/O”和“事件驱动”，这使得它非常适合构建高性能、可扩展的网络应用。对于我们那个后台系统来说，最头疼的问题就是并发访问卡顿严重，而 Node.js 完美地解决了这个问题。
此外，Node.js 让 JavaScript 第一次走出了浏览器，真正实现了“同语言打通前后端”的愿景。这对于团队协作来说是个巨大利好 —— 前端的同学可以更容易参与接口开发，沟通成本大大降低。
我的第一个项目：从零搭建 API 服务
我们的目标是为前台提供一系列 RESTful 接口来支持数据交互。整个服务需要实现以下几个功能：
- 用户登录鉴权
- 数据增删改查（CRUD）
- 文件上传处理
- 日志记录与错误处理
技术选型
- 框架：Express.js
- 数据库：MongoDB + Mongoose
- 身份验证：JWT + bcrypt.js
- 日志系统：Winston + Morgan
- 调试工具：Postman、Chrome DevTools、VS Code Debugger
实践过程中的关键代码
下面是一些核心代码片段，帮助你快速了解如何使用 Express 构建基础服务。
初始化项目结构
mkdir my-node-app
cd my-node-app
npm init -y
npm install express mongoose dotenv cors helmet morgan winston bcryptjs jsonwebtoken
创建入口文件 app.js：
const express = require('express');
const app = express();
const cors = require('cors');
const routes = require('./routes');
// 中间件配置
app.use(cors());
app.use(express.json());
app.use(routes);
const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
console.log(`Server running on http://localhost:${PORT}`);
});
用户登录路由逻辑
// routes/auth.js
const router = require('express').Router();
const User = require('../models/User');
const jwt = require('jsonwebtoken');
const bcrypt = require('bcryptjs');
router.post('/login', async (req, res) => {
const { username, password } = req.body;
try {
const user = await User.findOne({ username });
if (!user) return res.status(400).send('用户不存在');
const isMatch = await bcrypt.compare(password, user.password);
if (!isMatch) return res.status(400).send('密码错误');
const token = jwt.sign({ id: user._id }, 'your_jwt_secret', { expiresIn: '1d' });
res.header('x-auth-token', token).send({ token });
} catch (err) {
console.error(err.message);
res.status(500).send('服务器内部错误');
}
});
module.exports = router;
那些年我们一起踩过的坑
学习过程中遇到最大的几个问题如下：
1. 异步回调地狱（Callback Hell）
早期没掌握好 Promise 和 async/await 的写法，导致代码嵌套太深，难以阅读和维护。
解决方法：全面使用 async/await，并配合 try/catch 来捕获异常。
async function getUser() {
try {
const user = await User.findById(id);
return user;
} catch (error) {
throw new Error('获取用户失败');
}
}
2. JWT 过期与刷新机制混乱
一开始直接使用 token 一小时过期，结果前端频繁出现“未授权”的问题。
解决方案：引入 refreshToken，并在拦截器中自动刷新 token，前端通过 axios 封装统一处理。
3. 跨域问题困扰
本地测试一切正常，部署上线后跨域请求被浏览器拦截。
解决方案：使用 cors 中间件进行配置，并设置好 headers、methods 和 credentials 等选项。
app.use(cors({
origin: 'https://your-frontend.com',
credentials: true
}));
项目效果与收益
经过两个多月的重构和逐步替换，我们最终成功将旧后端全部迁移至 Node.js + Express 架构。上线后的效果非常明显：
- 平均响应速度提升了近 40%
- 开发效率显著提高，前后端同学都能高效协同
- 错误率下降了 60%，日志更清晰易排查
最重要的是，这个项目让我彻底爱上了 Node.js，也坚定了我向全栈工程师发展的决心。
给新手的一些建议
如果你刚刚开始学习 Node.js，我的建议是：
不要怕犯错，关键是动手去做 很多时候你以为懂了，但一上手就卡壳。多敲代码，哪怕只是模仿别人的例子，也比光看不练强一百倍。
善用调试工具 Chrome DevTools 的 Network 面板和 VSCode 的断点调试非常实用，能够帮你快速定位请求和数据问题。
关注性能优化 使用
compression中间件压缩响应体；合理设置缓存策略（比如 ETag）；避免频繁查询数据库。保持技术更新 Node.js 发展很快，Vite、NestJS、Prisma 等新工具层出不穷。建议多关注社区动态，适当引入新技术。
结语：写给未来的自己
回过头来看，那段每天熬夜折腾 Node.js 的日子其实特别值得。不仅是因为学到了技术，更是因为这段经历锻炼了我的问题解决能力和持续学习的耐心。
现在我已经熟练使用 NestJS 和 GraphQL 来构建企业级服务，但 Node.js 依然是我最爱的语言之一。
希望这篇文章能给你带来一些启发和信心。记住，技术没有捷径，只有一步一个脚印。加油！
评论 0