根本原因是node调试器不读取.swcrc的sourcemaps路径且不自动关联ts/jsx编译产物，仅识别sourcemappingurl注释或inlinesourcemap；swc默认external模式与node inspector兼容性差，需设"sourcemaps": "inline"并配合tsconfig中"sourcemap": true和"inlinesources": true。
VSCode调试Node时SWC生成的source map不被识别
根本原因不是SWC没输出source map，而是Node调试器默认不读取.swcrc里配置的sourceMaps路径，也不自动关联TS/JSX编译产物。VSCode的Node调试器只认sourceMappingURL注释或inlineSourceMap，而SWC默认用sourceMaps: "inline"或"external"，但Node inspector对后者支持不稳定。
实操建议：
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 在
.swcrc中显式设"sourceMaps": "inline"，避免生成独立.map文件 - 确保
tsconfig.json里"sourceMap": true和"inlineSources": true同时开启——这是Node调试器能定位原始TS行号的前提 - 不要依赖
swc-cli --watch自动生成的map路径；改用swc-node或@swc-node/register，它们会自动注入兼容Node inspector的source map头 - 验证是否生效：启动
node --inspect-brk -r @swc-node/register src/index.ts，然后在Chrome DevTools里检查Sources面板下是否有webpack://或file://开头的原始TS路径
launch.json里type=node但断点停在编译后代码而非TS源码
这是因为VSCode没把source map映射规则传给Node调试器，或者映射路径格式不匹配。SWC输出的source map常含sources: ["src/index.ts"]，但Node inspector实际加载的是dist/index.js，两者路径基址不一致。
实操建议：
- 在
launch.json中加"sourceMapPathOverrides"，例如：{"src/*": "${workspaceFolder}/src/*"}——注意这里不是webpack:///前缀，SWC不用Webpack路径协议 - 必须设
"outFiles"指向编译产物目录，如["${workspaceFolder}/dist/**/*.js"]，否则VSCode无法反向查找源码 - 禁用
resolveSourceMapLocations（它对SWC无效），SWC的map是内联或同名外置，不需要通配搜索 - 如果用了
swc-node/register，去掉program字段，改用"runtimeExecutable": "node"和"args": ["-r", "@swc-node/register", "${workspaceFolder}/src/index.ts"]
TS装饰器+SWC编译后VSCode断点跳转失败
不是装饰器语法错了，是TS语言服务和SWC transform对装饰器版本的理解错位。比如.swcrc设了decorator.version = "2022-03"，但tsconfig.json还是"experimentalDecorators": true，TS插件就认为装饰器非法，连带source map解析失败。
实操建议：
-
tsconfig.json必须关掉"experimentalDecorators"，改用"decorators": true（TS 5.0+）且"target": "ES2022"或更高 -
.swcrc里jsc.transform.decorator要设{"version": "2022-03", "legacy": false}，与TS保持一致 - 改完配置后，必须手动执行
Developer: Restart TS Server，否则VSCode仍按旧规则解析TS文件 - 检查
node_modules/@swc/core版本是否≥1.4.0，旧版SWC对TS 5.0装饰器支持不全，会导致source map丢失装饰器节点信息
SWC编译快但调试时变量值显示为undefined
常见于const声明提升、箭头函数作用域或TS类型擦除后变量名被压缩。SWC默认不开keepClassNames和keepFnNames，编译后函数名变成_a、_b，Debug Console里查不到原始变量名。
实操建议：
- 在
.swcrc的jsc段加"keepClassNames": true和"keepFnNames": true，牺牲少量体积换调试体验 - 避免在
async函数里直接对await结果设断点；SWC可能将Promise链转成状态机，原始变量名会被重命名——改在await语句下一行设断点 - 如果用
swc-node/register，确保package.json里"type": "module"已设，否则CommonJS模块下import语句会被转成require，source map路径映射失效
keepFnNames未开启——前者让语法检查错乱，后者让变量监控失效。
