常见原因排查#

When 条件不满足#

VSCode 很多快捷键有 when 条件限制，比如 workbench.editor.activeGroupCenter 表示焦点必须在编辑器中心标签页。焦点在侧边栏、终端、通知栏时，这些快捷键不会响应（静默不执行）。

验证方法：在快捷键面板（Ctrl + K Ctrl + S）搜索按键，查看 when 列，确认当前焦点状态是否匹配。

问题表现#

按 Shift + Alt + F 格式化Python代码时弹窗提示：没有安装用于"python"文件的格式化程序

解决方案#

推荐安装 Black Formatter（最流行的Python格式化工具）：

• 点击弹窗的「安装格式化程序…」→ 选择 Black Formatter
• 或手动安装：Ctrl + Shift + X → 搜索 Black Formatter → 安装 ms-python.black-formatter

安装后按 Shift + Alt + F 即可格式化Python代码。