VSCode 禁用保存自动格式化全攻略

一、问题背景

VSCode 默认支持保存时自动格式化代码（Auto Formatting on Save），虽然能提升代码规范性，但也可能导致以下问题：

• 与团队代码风格冲突
• 频繁格式化干扰编码流程
• 特定场景下不需要自动排版

二、解决方法

方法 1：全局禁用（推荐）

适用场景：所有项目均不需要自动格式化

1. 打开设置界面

   • 快捷键：Ctrl+, (Windows/Linux) 或 Cmd+, (Mac)
   • 或搜索栏输入 settings.json

2. 添加配置项

   {
     "editor.formatOnSave": false
   }
   
   

3. 效果验证

   • 保存文件时不再触发格式化，但保留快捷键 Shift+Alt+F 手动格式化能力。

方法 2：按语言/文件类型禁用

适用场景：仅针对特定编程语言（如 JavaScript/Python）关闭

• {
     "[javascript]": {
      "editor.formatOnSave": false
   },
   "[python]": {
     "editor.formatOnSave": false
   }
  }
  
  

方法 3：工作区级配置

适用场景：仅在当前项目禁用（不修改全局设置）

1. 创建 .vscode 文件夹（若无）

2. 添加 settings.json 并写入

   {
     "editor.formatOnSave": false
   }
   
   

方法 4：通过命令面板操作

适用场景：仅在当前项目禁用（不修改全局设置）

1. 快捷键调出命令面板：Ctrl+Shift+P / Cmd+Shift+P

2. 输入 Format On Save → 选择 Disable Format On Save

三、高级技巧

1. 保留缩进但不格式化
   若需保持现有缩进但禁止结构调整：

   {
     "editor.formatOnSave": false,
    "editor.defaultFormatter": null
   }
   
   
   

2. 自定义格式化规则
   若需保持现有缩进但禁止结构调整：

   • 安装对应语言的 Prettier/ESLint 等插件
   • 修改配置文件（如 .prettierrc 或 .eslintrc）

3. 自定义格式化规则
   通过快捷键手动触发：

   • 格式化整个文档：Shift+Alt+F
   • 格式化选中代码：Ctrl+K Ctrl+F (Windows) / Cmd+K Cmd+F (Mac)

四、常见问题排查

1. 设置未生效？

   • 确认配置文件路径正确（用户级 vs 工作区级）
   • 检查是否有其他插件覆盖此设置（如 Prettier）

2. 特定语言仍自动格式化？
   可能需单独禁用该语言的格式化器

   {
    "javascript.format.enable": false,
    "python.formatting.provider": null
   }
   
   

3. 团队协作建议
   通过快捷键手动触发：

   • 推荐统一使用 .editorconfig 规范风格
   • 通过 Git Hook 或 CI/CD 强制格式检查