可行但需规避两大陷阱：一是禁用nodemon等热更新工具以防调试器冲突，二是为每个微服务单独配置launch.json并设独立端口与env；因VSCode调试器仅识别JS，program不能直指.ts文件，须通过-r ts-node/register预加载或指向ts-node bin脚本。
直接用 ts-node 调试微服务在 VSCode 里可行，但必须绕开两个关键陷阱：一是 Node.js 进程热更新（如 nodemon）与 VSCode 调试器的冲突；二是多服务并行启动时断点无法命中或调试会话被抢占。
为什么 launch.json 里不能写 "program": "${workspaceFolder}/src/main.ts"
VSCode 的 node 调试器默认只认 JavaScript 文件。如果直接把 .ts 文件路径塞进 program 字段，调试器会报错 Cannot find module 'xxx.ts' 或静默失败——它根本不会触发 ts-node 编译逻辑。
- 正确做法是让 Node.js 启动时通过
-r ts-node/register预加载 TypeScript 支持 -
program必须指向一个真实存在的 JS 入口（比如node_modules/ts-node/dist/bin.js），或干脆不设program，改用runtimeExecutable+runtimeArgs - 若项目用了
nodemon，绝对不要把它写进preLaunchTask—— 它会 fork 新进程，VSCode 调试器无法 attach
如何支持多个微服务同时调试（如 auth + api + gateway）
单个 launch.json 配置只能启动一个调试会话。微服务场景下，每个服务需要独立的端口、环境变量和断点控制，硬塞进一个配置里必然失效。
Galileo TypeScript sdk
下载
完整的Galileo AI平台 TypeScript/JS SDK 参考，用于评估、观察和保护 GenAI 应用。适用于构建 Node.js 或 TypeScript 项目。
- 每个服务目录下单独建
.vscode/launch.json，避免路径变量（如${workspaceFolder}）跨服务错乱 - 用
env字段显式设置服务专属变量，例如"PORT": "3001"、"NODE_ENV": "development" - 启用
autoAttachChildProcesses: true（VSCode 1.78+），否则子进程（如 cluster 模式下的 worker）的断点会失效 - 避免所有服务共用同一个
outFiles路径，否则 source map 映射会串扰
tsconfig.json 里哪些选项影响调试体验
不是所有编译选项都和调试有关，但几个关键项没配对，断点就停不到源码上。
-
"sourceMap": true是必须的，没有它，VSCode 不知道 JS 行号对应哪行 TS -
"inlineSourceMap": false（推荐），否则 source map 写进 JS 文件里，某些调试器解析不稳定 -
"outDir"和"rootDir"必须匹配launch.json中的outFiles和program路径逻辑，否则断点灰色不可用 -
"composite": true在 monorepo 微服务中很有用，配合references可让跨服务类型跳转生效，但会略微拖慢 tsc --watch
调试时 console.log 输出乱码或看不到日志
这不是编码问题，而是 Node.js 启动方式和终端输出流的权限/缓冲策略导致的。
- 确保
console输出未被重定向或捕获（比如某些日志库如pino默认禁用彩色输出，加transport: { target: 'pino-pretty' }可恢复） - 在
launch.json中添加"console": "integratedTerminal"，避免输出被调试器内部 buffer 截断 - 微服务常用
process.env.NODE_OPTIONS='--inspect=0.0.0.0:9229'，但 VSCode 调试器默认不监听外部 inspector，得手动配"port": 9229并关掉autoAttachChildProcesses才能 attach 上
最易被忽略的是微服务间依赖的 TypeScript 类型引用：如果 auth 服务 import 了 shared-types 包但没在 tsconfig.json 的 include 或 references 里声明，VSCode 会提示类型错误，但调试器照常运行——你可能花半小时查“断点不命中”，结果只是因为某处 import type 没被编译器识别，导致生成的 JS 里少了对应代码块。
