VS Code C/C++ IntelliSense解析文件陷入无限循环问题求助

问题现象 #

VS Code通过Remote-SSH连接Fedora远程机器时，C/C++ IntelliSense陷入无限解析循环，代码着色、悬停查看定义等核心功能完全失效，触发悬停操作后会进入无限加载状态。

环境信息 #

• 本地系统：Apple M1 Pro Mac OS Sonoma 14.4.1
• VS Code版本：1.88
• C/C++扩展版本：最新版
• 远程系统：Fedora Linux 38（Server Edition）

当前配置 #

.vscode目录包含c_cpp_properties.json和空白的settings.json（曾尝试添加多种配置均无效），c_cpp_properties.json内容如下：

{
    "configurations": [
        {
            "name": "Linux",
            "includePath": [
                "${workspaceFolder}/**"
            ],
            "defines": [],
            "compilerPath": "/usr/lib64/ccache/clang",
            "cStandard": "c17",
            "cppStandard": "c++17",
            "intelliSenseMode": "linux-clang-x64"
        }
    ],
    "version": 4
}

已尝试的排查手段 #

• 移除所有其他扩展以隔离问题
• 删除.vscode、.vscode-server目录及.cache等缓存文件，重启VS Code后自动重新生成，但问题依旧

诊断日志信息 #

~~~~~~~~~~~~~~~~~**Log Diagnostics**~~~~~~~~~~~~~~~~~~~~~~~~

-------- Diagnostics - 4/25/2024, 6:12:59 PM
Version: 1.19.9
Current Configuration:
{    "name": "Linux",    "includePath": [        "/home/accts/ckk25/**"    ],    "defines": [],    "compilerPath": "/usr/lib64/ccache/clang",    "cStandard": "c17",    "cppStandard": "c++17",    "intelliSenseMode": "linux-clang-x64",    "compilerPathIsExplicit": true,    "cStandardIsExplicit": true,    "cppStandardIsExplicit": true,    "intelliSenseModeIsExplicit": true,    "compilerPathInCppPropertiesJson": "/usr/lib64/ccache/clang",    "mergeConfigurations": false,    "browse": {        "path": [            "/home/accts/ckk25/**",            "${workspaceFolder}"        ],        "limitSymbolsToIncludedHeaders": true    }}
cpptools version (native): 1.19.9.0
Translation Unit Mappings:
[ /home/accts/ckk25/cs223Main/hw5/Island.cpp - source TU]:
[ /home/accts/ckk25/cs223Main/hw7/main.cpp - source TU]:
Translation Unit Configurations:
[ /home/accts/ckk25/cs223Main/hw5/Island.cpp ]:
    Process ID: 708586
    Memory Usage: 79 MB
    Compiler Path: /usr/lib64/ccache/clang
    Includes:
        /usr/include/c++/13
        /usr/include/c++/13/x86_64-redhat-linux
        /usr/include/c++/13/backward
        /usr/lib64/clang/16/include
        /usr/local/include
        /usr/include
    Standard Version: c++17
    IntelliSense Mode: linux-clang-x64
    Other Flags:
        --clang
        --clang_version=160006
[ /home/accts/ckk25/cs223Main/hw7/main.cpp ]:
    Process ID: 708552
    Memory Usage: 104 MB
    Compiler Path: /usr/lib64/ccache/clang
    Includes:
        /usr/include/c++/13
        /usr/include/c++/13/x86_64-redhat-linux
        /usr/include/c++/13/backward
        /usr/lib64/clang/16/include
        /usr/local/include
        /usr/include
    Standard Version: c++17
    IntelliSense Mode: linux-clang-x64
    Other Flags:
        --clang
        --clang_version=160006
Total Memory Usage: 183 MB

------- Workspace parsing diagnostics -------
Number of files discovered (not excluded): 40666

解决方案 #

1. 缩小IncludePath范围并排除无关目录 #

日志显示工作区扫描到40666个文件，${workspaceFolder}/**的递归扫描范围过宽，导致解析过载。修改c_cpp_properties.json，仅包含项目实际需要的头文件目录，并排除无关文件夹：

{
    "configurations": [
        {
            "name": "Linux",
            "includePath": [
                "${workspaceFolder}/cs223Main/hw5/include",
                "${workspaceFolder}/cs223Main/hw7/include",
                "${workspaceFolder}/**/*.h"
            ],
            "excludePath": [
                "${workspaceFolder}/**/build",
                "${workspaceFolder}/**/.git",
                "${workspaceFolder}/**/node_modules"
            ],
            "defines": [],
            "compilerPath": "/usr/lib64/ccache/clang",
            "cStandard": "c17",
            "cppStandard": "c++17",
            "intelliSenseMode": "linux-clang-x64"
        }
    ],
    "version": 4
}

2. 替换ccache clang为原生clang #

ccache的编译器包装器可能干扰IntelliSense的正常探测。先在远程机器执行which clang获取原生clang路径，再修改compilerPath：

"compilerPath": "/usr/bin/clang"

3. 调整IntelliSense配置缓解解析压力 #

在settings.json中添加以下配置，限制解析范围并降低资源占用：

{
    "C_Cpp.intelliSenseEngine": "Tag Parser",
    "C_Cpp.scanIncludedFiles": true,
    "C_Cpp.maxDatabaseSize": 1000000,
    "C_Cpp.workspaceParsingPriority": "low"
}

待功能恢复后，可切换回默认引擎："C_Cpp.intelliSenseEngine": "Default"

4. 强制重启IntelliSense服务 #

打开命令面板（Ctrl+Shift+P），依次执行：

• C/C++: Reset IntelliSense Database
• C/C++: Restart IntelliSense Engine

5. 检查远程机器资源 #

在远程机器执行htop查看CPU和内存占用，关闭其他高资源进程，避免因资源不足导致解析卡顿。

内容的提问来源于stack exchange，提问作者Legolas314