如何在Docker容器中用VS Code为ts-node运行的TypeScript应用正确设置断点？

我之前也碰到过这个一模一样的坑！核心原因是ts-node默认在内存中编译TypeScript，生成的sourcemap仅存在内存里，VS Code调试器无法获取到这些临时的sourcemap文件，导致本地TS源码的行号和远程运行的JS代码行号不匹配——这就是为什么空行能设断点（TS编译后空行会被移除，对应JS里的有效行），但实际代码行不行的原因。

不用预编译TS到JS并保存sourcemap，只要调整几个配置就能让你直接在本地源码设置断点，试试下面的步骤：

1. 开启TypeScript的sourcemap生成 #

首先修改/tsconfig.json，开启sourceMap和inlineSources（后者可选，但能确保sourcemap里包含完整的源码内容，避免映射失败）：

{
  "compilerOptions": {
    "target": "ES2017",
    "module": "commonjs",
    "outDir": "./dist",
    "rootDir": "./src",
    "esModuleInterop": true,
    "sourceMap": true, // 强制生成sourcemap
    "inlineSources": true // 把TS源码嵌入sourcemap中
  }
}

2. 调整启动脚本，让ts-node生成并暴露sourcemap #

修改/package.json的start脚本，确保ts-node生成sourcemap并让调试器能获取到。你有两种选择：

选项A：直接用ts-node的调试命令 #

这种方式更直观，ts-node会自动处理sourcemap：

{
  "scripts": {
    "start": "ts-node --inspect=0.0.0.0:9229 --sourcemap src/index.ts"
  }
}

选项B：保留node --require方式，添加环境变量 #

如果习惯原来的写法，添加TS_NODE_SOURCE_MAP=true环境变量，强制ts-node生成sourcemap：

{
  "scripts": {
    "start": "TS_NODE_SOURCE_MAP=true node --inspect=0.0.0.0:9229 --require ts-node/register src/index.ts"
  }
}

3. 修正VS Code的调试配置 #

调整/.vscode/launch.json，确保sourcemap映射正确，并且覆盖整个工作区路径：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "attach",
      "name": "Attach to Docker",
      "address": "localhost",
      "port": 9229,
      "protocol": "inspector",
      "localRoot": "${workspaceFolder}", // 映射整个工作区，而非仅src
      "remoteRoot": "/home/node/app",
      "sourceMaps": true, // 明确开启sourcemap支持
      "skipFiles": ["<node_internals>/**"] // 跳过Node.js内部文件，调试更清爽
    }
  ]
}

4. 优化Docker文件权限（可选但推荐） #

默认情况下，COPY命令会用root权限复制文件，可能导致node用户无法读取或修改文件。修改/Dockerfile，确保文件归node用户所有：

FROM node
RUN mkdir /home/node/app
WORKDIR /home/node/app
COPY package.json /home/node/app
RUN npm install && npm cache clean --force
COPY --chown=node:node . /home/node/app # 让node用户拥有所有文件
CMD [ "npm", "start" ]

验证效果 #

重启docker-compose up，然后在VS Code中启动调试器（Attach to Docker）。现在你可以直接在本地/src/index.ts的代码行设置断点，不需要添加debugger语句，断点会正常触发！

原理是开启sourcemap后，ts-node会把TS源码和JS代码的映射信息传递给调试器，VS Code就能准确关联本地源码和远程运行的代码行号，自然就能正常断点了。

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