Live Share 调试共享需手动勾选 Debugging 选项、使用相对路径配置 launch.json、协作者须安装对应调试扩展并确保源码一致。

不能一键共享调试脚本本身,但能一键共享正在运行的调试会话——关键在于让同事“看到并参与你的调试上下文”,而不是传文件。
Live Share 启动时必须勾选 Debugging 能力
默认情况下,Live Share: Start Collaboration Session 弹窗里 Debugging 选项是关闭的。不手动勾选,协作者连断点都看不到,更别说控制执行流程。
- 启动前务必确认弹窗中
Debugging复选框已打钩(不是靠 settings.json 配置覆盖) - 如果已开启会话但没勾选,必须退出重来——中途无法动态启用调试共享
-
"liveshare.debugging": true这类配置项只影响新会话的默认状态,不改变当前运行中的会话行为
launch.json 配置必须可被 Live Share 正确识别
Live Share 不解析或转发 launch.json 文件内容,它只同步“当前激活的调试会话状态”。所以你本地能跑通,不代表协作者能复现。
- 确保
launch.json中的program、cwd、env等路径使用${workspaceFolder}等相对变量,避免硬编码绝对路径 - 若调试依赖本地二进制(如
riscv64-unknown-elf-gdb),协作者机器上无需安装同名工具——Live Share 只共享会话控制权,不共享执行环境 - Node.js 项目中,
request: "attach"模式比"launch"更稳定,因为不依赖协作者本地启动进程
协作者加入后常卡在“无断点/无法继续”?检查这三点
这不是网络延迟问题,而是调试上下文未对齐的典型表现。
- 你必须已在某个文件中设置了至少一个有效断点,并且已点击
F5或 “Start Debugging” 启动了会话——Live Share 不会帮你启动调试器 - 协作者打开的文件必须和你当前调试的源码完全一致(Git commit hash 相同),否则断点位置错位,VSCode 会静默忽略
- 如果你用的是自定义调试器(如
cppdbg或pwa-node),协作者必须已安装对应扩展,否则调试面板显示空白
最易被忽略的一点:Live Share 共享的是“调试控制权”,不是“调试能力”。协作者能否单步、查看变量、修改内存,取决于他本地是否具备匹配的调试器扩展和符号文件——这些没法随链接自动安装。











