VSCode代码自动格式化有五种方法:一、快捷键Shift+Option+F;二、命令面板输入Format Document;三、设置中启用Format On Save;四、安装Prettier等语言专属扩展并配置默认格式化器;五、多光标编辑与Format Selection辅助局部格式化。

如果您在使用 VSCode 编辑代码时发现缩进混乱、括号错位或语句未对齐,可能是由于未启用或未正确配置代码格式化功能。以下是实现代码自动格式化的多种方法:
本文运行环境:MacBook Air,macOS Sequoia。
一、使用快捷键触发格式化
VSCode 提供了内置的快捷键组合,可快速对当前打开的文件执行格式化操作,该方式不依赖扩展,适用于已配置默认格式化程序的语言。
1、确保光标位于待格式化的代码文件中。
2、按下 Shift + Option + F(macOS)或 Shift + Alt + F(Windows/Linux)。
3、若首次使用且未设置默认格式化工具,VSCode 会弹出提示框,要求您选择一个格式化程序。
二、通过命令面板执行格式化
命令面板提供统一入口,可绕过快捷键冲突或键盘布局限制,精准调用格式化命令。
1、按下 Cmd + Shift + P(macOS)或 Ctrl + Shift + P(Windows/Linux)打开命令面板。
2、输入 Format Document 并回车。
3、如需为当前语言指定格式化器,可在命令面板中输入 Format Document With... 后选择对应工具。
三、配置保存时自动格式化
启用此选项后,每次保存文件时 VSCode 将自动应用格式化规则,避免手动触发遗漏,提升编码一致性。
1、打开 VSCode 设置界面(Cmd + ,)。
2、在搜索栏中输入 format on save。
3、勾选 Editor: Format On Save 选项。
4、如需仅对特定语言启用,可在设置中搜索 format on save mode 并设为 file 或 modifications。
四、安装并配置语言专属格式化扩展
VSCode 自带的基础格式化能力有限,多数现代语言需借助第三方扩展实现语义级格式化,例如 Prettier 之于 JavaScript,Black 之于 Python。
1、点击左侧扩展图标(或按 Cmd + Shift + X)。
2、搜索并安装对应语言的推荐格式化工具,如 Prettier(JavaScript/TypeScript)、Python(含 Black 支持)、ESLint(配合格式化修复)。
3、安装完成后,在用户设置或工作区设置中添加如下配置项:
"editor.defaultFormatter": "esbenp.prettier-vscode"
"[javascript]": { "editor.formatOnSave": true }
五、使用多光标与编辑器操作辅助格式化
对于局部代码块或非标准语法结构,可结合多光标编辑与手动结构调整,作为自动化格式化的补充手段。
1、按住 Option 键(macOS)并点击多处位置,创建多个插入点。
2、输入统一缩进符(如两个空格)或删除多余字符,实现批量对齐。
3、使用 Cmd + [ 或 Cmd + ] 对选中行进行整体缩进调整。
4、选中目标代码段后,右键选择 Format Selection 单独格式化该区域。










