如何在Node.js中获取对应TypeScript文件行号的错误信息？

哈哈，这个坑我之前做Node.js后端开发的时候也踩过！看着错误日志里的JS行号翻半天找不到对应TS代码的滋味太难受了😣，其实只要配置好Source Map，就能让Node.js直接显示TS文件的行号和代码位置，下面给你一步步讲怎么实现：

1. 先在TypeScript配置里开启Source Map #

首先得让TypeScript在转译时生成Source Map文件（.map），这些文件会把编译后的JS代码映射回对应的TS源码。修改你的tsconfig.json，在compilerOptions里加上这些关键配置：

{
  "compilerOptions": {
    "sourceMap": true, // 核心：开启Source Map生成
    "outDir": "./dist", // 指定转译后的JS文件输出目录
    "rootDir": "./src", // 指定TS源码的根目录，必须和outDir对应，否则映射会混乱
    "target": "ES2020", // 选择符合你Node.js版本的目标语法
    "module": "CommonJS" // 后端常用的模块系统
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules"]
}

配置好之后运行tsc转译代码，你会发现dist目录里每个.js文件旁边都多了一个对应的.js.map文件，这就是用来做源码映射的关键文件。

2. 让Node.js加载Source Map #

生成了Source Map还不够，得告诉Node.js去读取它，这里有几种常用的实现方式：

方式一：用Node.js原生参数（生产/开发通用） #

从Node.js 12.12.0版本开始，官方支持--enable-source-maps参数，运行转译后的JS文件时加上这个参数即可：

node --enable-source-maps dist/index.js

这样后续报错时，控制台就会直接显示TS原文件的行号和代码片段了！

方式二：用ts-node直接运行TS文件（开发阶段更高效） #

如果是开发阶段，不想每次修改代码都手动转译，可以用ts-node直接运行TS源码，它会自动处理Source Map，不需要额外配置：

ts-node src/index.ts

要是配合nodemon做热重载，还可以在项目根目录新建nodemon.json配置文件：

{
  "watch": ["src"],
  "ext": "ts",
  "exec": "ts-node src/index.ts"
}

之后运行nodemon，代码修改后会自动重启，报错也直接显示TS行号。

方式三：PM2生产环境配置 #

如果用PM2管理生产进程，启动时加上--enable-source-maps参数就行：

pm2 start dist/index.js --enable-source-maps

或者在ecosystem.config.js里统一配置：

module.exports = {
  apps: [
    {
      name: "your-app",
      script: "./dist/index.js",
      args: "--enable-source-maps"
    }
  ]
};

3. 额外注意事项 #

• 一定要保证rootDir和outDir的路径对应，否则Source Map的映射关系会出错，导致行号依然不匹配。
• 如果用了webpack等打包工具，要在打包配置里开启Source Map（比如webpack的devtool: 'source-map'），不过Node.js后端一般用tsc直接转译就足够了。
• 生产环境开启Source Map不会影响运行性能，只是多了几个.map文件，这些文件仅用于错误映射，不会被执行。

这样配置完之后，再遇到错误你就能直接定位到TS文件的具体行，不用再对着JS文件瞎找啦！

内容的提问来源于stack exchange，提问作者Deepak Poojari