VSCode设置editor.codeActionsOnSave自动变更为explicit

问题描述

开发者在React项目中配置VSCode工作区设置时（使用ESLint、Prettier和Vite），遇到了settings.json中的保存操作设置自动变更问题。具体表现为：

"editor.codeActionsOnSave": {
  "source.fixAll.eslint": true, // 自动变为"explicit"
  "source.organizeImports": true // 自动变为"explicit"
}

即使开发者明确设置为true，这些值总会在以下情况自动变更为"explicit"：

• 重新打开VSCode时
• 编写代码过程中
• 保存文件时

原因分析

重要发现

此问题是由VSCode 1.85.0版本更新引起的兼容性变更。在1.84.0及更早版本中，editor.codeActionsOnSave支持布尔值（true/false），但从1.85.0开始：

1. 这些设置必须使用字符串枚举值而非布尔值
2. 布尔值true的新等效值为"explicit"
3. VSCode会自动将旧的布尔值转换为对应的枚举值

根据官方更新日志：

• VSCode 1.85.0更新说明明确指出此变更
• VSCode 1.83.0更新说明为布尔值的最后一次支持版本

解决方案

正确配置方法

修改.vscode/settings.json，使用字符串值替代布尔值：

{
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": "explicit", 
    "source.organizeImports": "explicit"
  },
  "editor.formatOnSave": true,
  "editor.wordWrap": "on",
  "editor.defaultFormatter": "esbenp.prettier-vscode"
}

配置说明

• "explicit"：等同于原先的true，在手动保存时触发操作(Ctrl+S/Cmd+S)
• "never"：等同于原先的false，禁用操作
• "ifAvailable"：新的实验性选项（不建议用于此场景）

确认VSCode版本

使用以下步骤检查VSCode版本：

1. Windows/Linux：帮助 > 关于
2. macOS：Code > 关于 Visual Studio Code
3. 推荐：升级至最新版本（当前≥1.85.0）

完整项目配置验证

检查以下关联配置文件确保无冲突：

module.exports = {
  // ...其他配置
  plugins: ["react-refresh", "eslint-plugin-react", "prettier"],
  rules: {
    "prettier/prettier": "error", // 确保已启用prettier集成
    // ...其他规则
  }
};

{
  "singleQuote": false,
  // 确保没有禁用eslint集成
  "eslintIntegration": false // 正确: Prettier不接管ESLint修复
}

技术原理详解

变更背景

VSCode团队对保存操作的执行逻辑进行了重构：

1. 区分显式保存(手动触发)和自动保存
2. 细化操作触发的粒度控制
3. 统一配置格式为字符串枚举类型

工作原理解析

使用"explicit"后：

• 仅在手动保存时执行操作
• 避免与自动保存功能冲突
• 保持Prettier的editor.formatOnSave独立运行

补充建议

多项目协作配置

在团队项目中：在仓库根目录添加.vscode/settings.json确保所有开发者配置一致

疑难排查

若问题仍然存在：

1. 禁用所有VSCode扩展再测试
2. 清理设置缓存：

   rm -rf ~/Library/Application\ Support/Code/User/workspaceStorage/*

3. 检查有无冲突的全局设置（Ctrl+,打开设置）

扩展管理

确保安装官方扩展：

• ESLint
• Prettier

通过以上配置修正，VSCode工作区设置将保持稳定，ESLint修复和导入整理功能会在保存时正确触发。