盯着终端里那一行行猩红色的报错信息，你是不是也感觉拳头硬了？nodejs学习的第一道坎往往不是什么复杂算法，而是这些看似无解的报错。后台经常收到这样的留言：“照着教程写，npm start一按，直接崩了，连错在哪都不知道。”今天就专门揪出几个最常见也最坑的典型，帮你省下通宵debug的精力。

先别急着搜报错，这几个常见坑我替你踩过了

　　第一个坑就是端口占用。很多人第一次启动Express或者Koa，默认监听3000端口。如果之前开过没关掉，或者有其他服务占着，终端会直接报EADDRINUSE。这时候别慌，先查一下哪个进程占了端口。Windows用netstat -ano | findstr :3000，Mac/Linux用lsof -i :3000，找到PID然后kill掉就行。你以为是代码写错了，其实只是进程没关。

　　第二个坑是npm依赖冲突。新手经常遇到node_modules里缺包或者版本不兼容。有的朋友可能遇到过npm install之后提示ERR! code ENOENT，或者peer dependency mismatch。解决办法很简单：删掉node_modules和package-lock.json，重新npm install。如果还不行，检查package.json里的版本号是不是写得太死了。用^或~留一点弹性空间，能减少很多冲突。

　　第三个坑是模块找不到。你明明写了require('./utils')，但Node告诉你Cannot find module。多半是路径写错了，或者文件后缀没加。记得Node.js对./的相对路径很敏感，拼错一个字符就报错。另外如果是JSON文件，一定要加.json后缀。

　　说个更玄学的：有时候改了代码，终端里跑的却是旧版本。那是没重启进程。用nodemon这种自动重启的工具，或者手动Ctrl+C再起一次。

回调地狱？一把Promise拆掉它

　　nodejs学习到异步这里，很多人就卡死了。以前写同步代码，逐行执行。到了Node里，回调函数一层套一层，代码变成倒三角形。这就是著名的“回调地狱”。

　　别怕，方法很简单。把嵌套的回调改成链式Promise。比如读取一个文件再解析JSON，原来可能是这样的：fs.readFile('data.json', (err, data) => { if (err) throw err; JSON.parse(data.toString()); })。改成Promise：fs.promises.readFile('data.json').then(data => JSON.parse(data.toString())).catch(err => console.error(err))。代码一下子平了。

　　再进一步，用async/await更爽。直接写：const data = await fs.promises.readFile('data.json'); const obj = JSON.parse(data.toString());。不过注意，await只能在async函数里用。这玩意儿很多新手忘了，就会报SyntaxError: await is only valid in async functions。看到了就知道了。

　　异步调试思路也很重要。别在异步回调里随便丢console.log，因为执行顺序跟你想象的不一样。按顺序打印可能会得到混乱的输出。建议在每个关键节点打标记，比如console.log('1. before read');、console.log('2. after read');，这样能清楚看到哪一步先执行。

　　有的朋友可能遇到过回调函数里return了但没效果，那是因为return的返回值没人接收，回调的返回值本质上只能被上层函数处理。别指望return能像同步函数一样跳出。遇到这种情况，换成Promise的resolve传递值。

　　记住一条铁律：异步代码里，能平铺就别嵌套。多用async/await，少写回调。配置文件出问题了？去官网扒说明书，那玩意儿最准。问题解决了就合上电脑，出去走走，别在这耗着。