VSCode插件自定义快捷键_VSCode自动美化代码格式【方案】-VSCode-PHP中文网

vscode自动格式化需格式化工具、快捷键绑定、触发条件三者对齐；shift+alt+f（win/linux）或shift+option+f（mac）默认调用formatdocument，但仅当文件语言模式正确、装有对应格式化器且配置了editor.defaultformatter时才生效。

vscode插件自定义快捷键_vscode自动美化代码格式【方案】

VSCode 自动格式化代码不是靠“装个插件就完事”，而是“格式化工具 + 快捷键绑定 + 触发条件”三者必须对齐；缺一不可，否则 Ctrl+S 之后代码纹丝不动。

最常见原因不是快捷键没绑，而是当前文件没被识别为对应语言，或没装能干活的格式化器。

右下角状态栏查看语言模式：如果是 Plain Text 或 Unsupported，右键切换为正确语言（如 JavaScript、Python）
检查是否安装了对应格式化插件：Prettier（JS/TS/HTML/CSS）、black-formatter（Python）、clang-format（C/C++）——VSCode 自带的缩进逻辑 ≠ 语义格式化
Shift+Alt+F（Windows/Linux）或 Shift+Option+F（macOS）默认调用的是 editor.action.formatDocument，但该命令只有在 editorTextFocus 且有可用格式化器时才执行
终端、设置页、搜索框里按这个组合键必然无效——它不满足 when 条件

开启 editor.formatOnSave 只是第一步，关键在“谁来格式化”和“能不能用上”。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

全局开启：在 settings.json 中加 "editor.formatOnSave": true
但必须配合语言级默认格式化器，否则保存时 VSCode 不知道调哪个插件：
"[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }
"[python]": { "editor.defaultFormatter": "ms-python.black-formatter" }
如果项目根目录有 .prettierrc 或 pyproject.toml，确保配置项不冲突（例如 tabWidth 和 editor.tabSize 不一致会导致格式化后又被重排）
禁用某语言的自动格式化？别删设置，直接写："[json]": { "editor.formatOnSave": false }

when 不是可选项，而是控制“这个键在哪儿能按”的开关；写错等于白配。

想在编辑器里生效（最常用）："when": "editorTextFocus"
只在终端里生效："when": "terminalFocus"
仅当文件是 Python 且未只读："when": "editorTextFocus && resourceExtname == '.py' && !editorReadOnly"
完全全局生效（慎用）：删掉 when 字段，或写成 "when": ""
查不到上下文变量？打开命令面板 → Developer: Inspect Context Keys，把光标点进目标区域再看浮层提示

Beautify 是老派工具，Prettier 是现代主流；两者共存大概率导致格式化结果反复横跳，尤其在 HTML/JS 混合文件中。

Beautify 默认不读 .prettierrc，也不支持 printWidth、semi 等核心规则
卸载 Beautify，改用 esbenp.prettier-vscode（官方推荐）或 prettierd（性能更好）
如果团队强制用 Beautify，务必在 settings.json 中锁定默认格式化器："editor.defaultFormatter": "HookyQR.beautify"，并禁用其他格式化插件
Beautify 的 Ctrl+Shift+F 和 Prettier 的默认快捷键相同——VSCode 会优先使用 when 更具体的那条，容易误触发