VSCode attach调试前必须确保目标进程已启用调试支持并监听对应端口。Node.js需用--inspect-brk启动，Python需debugpy.listen()加wait_for_client()，.NET Core需正确配置启动参数；launch.json中type、request、port、address须严格匹配；版本不兼容会导致连接失败或断点失效。
VSCode attach 调试前必须确认进程已启用调试支持
直接点：VSCode 的 attach 模式不会启动目标进程，它只连接——如果进程没开调试端口、没带调试参数、或调试器根本没监听，VSCode 就会卡在“正在尝试连接…”然后超时失败。
常见错误现象：Could not connect to debug target、Connection refused、VSCode 界面右下角一直显示“Attaching…”但无响应。
- Node.js 进程必须用
node --inspect=0.0.0.0:9229（或--inspect-brk）启动，不能只写--inspect（默认绑定127.0.0.1，Docker 或远程场景下连不上） - Python +
debugpy需提前在代码里插入debugpy.listen(5678)，且确保该端口未被占用、防火墙放行 - .NET Core 必须用
dotnet run --configuration Debug --launch-profile "" --no-launch-profile启动，并确认launchSettings.json中environmentVariables包含"DOTNET_STARTUP_PROJECT": "xxx.csproj"
launch.json 里 attach 配置的关键字段不能错
VSCode 不靠“猜”，它严格按 launch.json 的 type、request、port、address 去建连接。填错任意一个，就是白配。
使用场景：本地调试 Docker 容器内 Node 服务、远程服务器上的 Python 脚本、Windows 上挂起的 .NET 进程。
-
request必须是"attach"（不是"launch"） -
port必须和目标进程实际监听的端口一致；若进程监听0.0.0.0:9229，这里就填9229 -
address默认是"localhost"，但如果目标在 Docker 容器或另一台机器，得改成对应 IP，比如"172.17.0.2"或"192.168.1.100" - Node.js 的
type是"pwa-node"（新版 Debugger for Edge / JS 已统一），旧插件用"node"可能连不上
示例（Node.js attach）：
{
"type": "pwa-node",
"request": "attach",
"name": "Attach to Process",
"port": 9229,
"address": "localhost",
"skipFiles": ["<node_internals>/**"]
}
调试器版本与运行时版本不匹配会导致 attach 失败
VSCode 调试器不是万能胶水——pwa-node 插件对 Node.js 版本有明确支持范围，debugpy 也分 v1.6/v1.7，低版本 debugpy 连不上 Python 3.12。
性能 / 兼容性影响：强行用不兼容版本 attach，可能连上但断点不命中、变量显示为 undefined、甚至目标进程崩溃。
- 查 Node.js 支持表：VSCode 官方文档中搜索
pwa-node version support，确认你用的 VSCode 版本对应哪个pwa-node内置版本，再核对 Node.js 是否在其列表内 - Python：运行
python -m debugpy --version，对比 VSCode Python 扩展的 release note 中声明的兼容版本 - Java：
java -version和vscode-java-debug的supportedJdks字段必须对齐，JDK 21 需要扩展 v0.49+，旧版直接拒绝 attach
attach 后断点不触发？先检查进程是否真在调试模式下运行
最常被忽略的一点：你以为 attach 上了，其实只是“TCP 连上了”，但目标进程根本没进入可调试状态。比如 Node.js 用 --inspect 启动后立刻退出（脚本执行完），或者 Python 的 debugpy.listen() 被调用但后面没跟 debugpy.wait_for_client()。
使用场景：调试短生命周期脚本、CLI 工具、单元测试子进程。
- Node.js 推荐加
--inspect-brk：进程启动即暂停，确保 VSCode 有足够时间 attach 上再继续 - Python 中，
debugpy.listen()后必须有debugpy.wait_for_client()（否则监听即返回，不阻塞） - 对于 fork 出的子进程（如 pytest 的
--forked），主进程 attach 上了，子进程仍是普通模式——得单独配置子进程的调试入口或改用debugpy的 fork 支持
验证是否真 attach 成功：VSCode 调试面板顶部应显示“已连接到 [进程名]”，且左下角调试工具栏出现暂停/继续按钮；如果只有“正在连接…”，说明还在握手阶段，别急着下断点。
