VSCode中cpp_properties.json每隔一分钟自动恢复默认值求解决

算力阿峰

2026-7-4

解决cpp_properties.json自动恢复默认配置的问题

问题描述

之前在cpp_properties.json的includePath中添加了自定义路径，原本正常使用，但该文件突然恢复为默认配置：

{
  "configurations": [
    {
      "name": "windows-gcc-x64",
      "includePath": [
        "${workspaceFolder}/**"
      ],
      "compilerPath": "C:/msys64/mingw64/bin/gcc.exe",
      "cStandard": "${default}",
      "cppStandard": "${default}",
      "intelliSenseMode": "windows-gcc-x64",
      "compilerArgs": [
        ""
      ]
    }
  ],
  "version": 4
}

重新添加路径保存后，每隔一分钟仍会自动恢复默认值，尝试查找相关解决方案但找不到对应文件，寻求其他解决办法。

可行解决方法

关闭C/C++扩展的自动配置功能
打开VS Code设置，搜索C_Cpp: Auto Add Configuration并关闭该选项；同时检查C_Cpp: Update Include Paths On Save，若开启也建议关闭，避免扩展自动覆盖自定义配置。
锁定配置文件
找到.vscode/cpp_properties.json文件，右键选择「属性」，勾选「只读」后应用。需要修改配置时再取消只读状态，防止扩展自动修改文件。
通过工作区设置指定包含路径
在工作区的.vscode/settings.json中添加自定义路径，优先级高于扩展自动生成的配置：
```
{
  "C_Cpp.default.includePath": [
    "${workspaceFolder}/**",
    "你的自定义路径1",
    "你的自定义路径2"
  ]
}
```
重置IntelliSense缓存
打开命令面板（Ctrl+Shift+P），执行C/C++: Reset IntelliSense Database，之后重启VS Code，再重新配置includePath。
排查插件冲突
暂时禁用其他C/C++相关插件（如CMake Tools），测试是否仍出现自动恢复问题，确认是否由插件冲突导致。