VSCode代码格式化需配置得当并及时触发。启用“保存时自动格式化”，安装对应语言插件（如Prettier、Black），配置.editorconfig统一规则，指定默认格式化工具，并排查扩展缺失、语言模式错误等常见问题。
VSCode 的代码格式化功能非常强大，关键在于配置得当、触发及时，而不是靠手动调整缩进或空格。
自动保存时自动格式化
这是最省心的方式。开启后，每次 Ctrl+S 保存文件，VSCode 就会按你设定的规则自动整理代码结构。
- 打开设置（Ctrl+,），搜索 format on save，勾选 Editor: Format On Save
- 确保当前语言有对应格式化工具（如 JavaScript 需 Prettier 或 ESLint，Python 需 autopep8 或 black）
- 如果只想对特定语言启用，可在用户设置 JSON 中添加：
"[javascript]": { "editor.formatOnSave": true },
"[python]": { "editor.formatOnSave": true }
快捷键手动触发格式化
随时整理当前文件或选中代码块，无需保存也能立刻看到效果。
- 整份文件：Windows/Linux 按 Shift+Alt+F，macOS 按 Shift+Option+F
- 仅格式化选中内容：先选中文本，再用相同快捷键
- 右键菜单里也提供“格式化文档”和“格式化选中的内容”选项
统一团队风格：配置 .editorconfig 和格式化插件
单靠 VSCode 默认规则不够稳定，尤其多人协作时容易出现缩进、换行不一致的问题。
- 在项目根目录加 .editorconfig 文件，统一基础规则（如 indent_style、charset、end_of_line）
- 安装对应语言的格式化插件，比如：Prettier（JS/TS/HTML/CSS）、Black（Python）、clang-format（C/C++）
- 在工作区设置中指定默认格式化工具，避免插件冲突：
"[typescript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }
格式化失效？检查这几点
不是所有文件都能一键变整齐，常见卡点就这几个。
- 没有安装对应语言的格式化扩展（VSCode 默认只支持基础缩进，不处理语义美化）
- 文件关联的语言模式错误（右下角查看是否显示为 “JavaScript”，而不是 “Plain Text”）
- 项目中有本地配置（如 prettier.config.js、.prettierrc）但格式不兼容或路径不对
- 设置了 editor.formatOnSave 却没生效，可能是被 workspace 设置覆盖了
基本上就这些。配好一次，之后写代码就像有了隐形助手——格式干净、协作顺畅、自己看着也舒服。
