如何配置Visual Studio Code实现代码自动格式化？

快捷键失效排查 #

• 按键操作逻辑错误：Ctrl + K Ctrl + D 为序列触发快捷键，正确操作方式为按住Ctrl键后按下K键、松开K键（保持Ctrl按住状态）再按下D键，三键同时按下或按键间隔过长都不会触发格式化命令。
• 快捷键冲突：按下Ctrl + K Ctrl + S打开键盘快捷方式面板，搜索「格式化文档」，查看对应快捷键是否被其他插件、自定义配置覆盖，若存在冲突可右键选择重置快捷键，或重新绑定习惯的按键组合。
• 缺少对应语言的格式化支持：VS Code 仅对少数内置语言提供基础格式化能力，Python、Java、C++、Vue等语言需要安装对应语言扩展（如Pylance、Java语言支持包、Volar等）才能触发语法级的格式化、缩进调整，纯文本模式下格式化命令不会生效。

自动格式化（含代码结构自动缩进）配置步骤 #

1. 按下Ctrl + ,打开设置面板，点击右上角的「打开设置(JSON)」图标，进入settings.json配置文件。
2. 添加以下基础配置，实现输入、保存、粘贴时自动调整方法、循环等代码结构的缩进：

{
    // 开启全量自动缩进，自动识别方法、循环、条件判断等嵌套结构调整缩进
    "editor.autoIndent": "full",
    // 保存文件时自动格式化
    "editor.formatOnSave": true,
    // 输入时自动格式化当前行
    "editor.formatOnType": true,
    // 粘贴内容时自动格式化粘贴片段
    "editor.formatOnPaste": true,
    // 单个Tab对应的缩进空格数，可根据团队规范调整，Python等语言建议设为4
    "editor.tabSize": 4,
    // 按下Tab键时插入空格而非制表符
    "editor.insertSpaces": true,
    // 自动识别当前文件的缩进规则，覆盖默认配置
    "editor.detectIndentation": true
}

3. 若安装了多个格式化插件，需要在配置中指定各语言的默认格式化器，避免多插件冲突导致格式化失效，示例配置如下：

"[javascript]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
},
"[python]": {
    "editor.defaultFormatter": "ms-python.python"
},
"[java]": {
    "editor.defaultFormatter": "redhat.java"
}

手动格式化操作参考 #

• 全文件格式化：Shift + Alt + F 是VS Code全平台通用的全文件格式化快捷键，触发逻辑更稳定，适配所有已安装格式化器的语言场景。
• 选中区域格式化：选中需要调整缩进的方法、循环等代码块，按下Ctrl + K Ctrl + F 可仅格式化选中片段，快速修复局部缩进错误。

注意：格式化前可以查看VS Code窗口右下角的语言模式标识，如果当前文件被识别为「纯文本」，需要手动点击标识切换到对应编程语言，否则格式化不会按语法规则调整缩进。

内容的提问来源于stack exchange，提问作者Roy Awill