按 Ctrl+Shift+F5(Windows/Linux)或 Cmd+Shift+F5(macOS)可重启当前调试会话,等价于点击调试工具栏的“重启”按钮;需确保调试已启动、焦点在编辑器内、launch.json 配置有效,且无扩展劫持该快捷键。

VSCode 里按什么快捷键能重启当前调试会话
直接按 Ctrl+Shift+F5(Windows/Linux)或 Cmd+Shift+F5(macOS),就能重启当前正在运行的调试会话——前提是调试已启动且焦点在编辑器内。这个快捷键不会启动新调试,也不会终止后手动点“开始调试”,它等价于点击调试工具栏上的“重启”按钮。
为什么有时候 Ctrl+Shift+F5 没反应
常见原因不是快捷键失效,而是调试上下文丢失:
- 调试会话已结束(比如程序自然退出或被手动停止),此时快捷键无效;必须先按
F5启动一次,才能用Ctrl+Shift+F5重启 - 焦点不在编辑器主区域(比如光标在终端、调试控制台或设置页),快捷键会被拦截或忽略
- 当前没有激活的调试配置(
launch.json缺失或configurations为空),VSCode 不知道“重启谁” - 某些扩展(如 Live Server、Prettier)可能劫持了
Ctrl+Shift+F5,可进Preferences: Open Keyboard Shortcuts搜索该组合键确认绑定
如何自定义或验证这个快捷键
VSCode 默认绑定是可靠的,但如果你改过键位或用的是非标准键盘布局,建议手动核对:
- 打开命令面板(
Ctrl+Shift+P),输入Preferences: Open Keyboard Shortcuts - 搜索
workbench.action.debug.restart,确认其快捷键确实是Ctrl+Shift+F5(或你期望的组合) - 如果想改成
F5双击触发重启(不推荐),需注意这会覆盖“启动调试”功能,容易误操作 - 重启调试本质是终止当前进程 + 重新执行
launch.json中的program或command,所以修改代码后直接按它,比手动停再启快得多
配合热重载时要注意的细节
Ctrl+Shift+F5 是硬重启:进程完全终止再拉起,和 Webpack/HMR 的“热更新”逻辑无关。它适合以下场景:
- 修改了
launch.json配置(比如加了env或改了args) - 调试器状态异常(断点不命中、变量显示
undefined但实际有值) - Node.js 进程卡死、Python 多线程残留句柄未释放
- 但如果你用的是
nodemon或ts-node --watch,它们自身监听文件变化并重启,此时再按Ctrl+Shift+F5就是双重重启,可能引发端口占用或重复日志
真正省时间的地方在于:不用切出编辑器、不用找调试工具栏、不用确认哪个配置在运行——只要调试条还在顶部,就说明上下文有效,直接按就行。


















