VSCode C++扩展提示仅返回类型区分重载错误但无函数重载问题

你遇到的错误仅出现在VS Code IntelliSense提示中，本质是IntelliSense解析逻辑缺陷+代码本身声明顺序不规范共同导致的，和实际函数重载无关。

相关复现代码 #

some_config.hpp #

auto initConfig(int i, char** a) -> CustomConfigType;

struct CustomConfigType
{
    // ...
};

some_config.cpp #

#include "some_config.hpp"

auto initConfig(int i, char** a) -> CustomConfigType
{
    // ...
}

configs_loader.cpp #

#include "some_config.hpp"
// ...
CustomConfigType config = initConfig(i, a);
// ...

对应VS Code C/C++配置 #

{
    "configurations": [
        {
            "name": "Linux",
            "includePath": [
                "${workspaceFolder}/**",
                // Other libraries here
            ],
            "defines": [],
            "compilerPath": "/usr/bin/g++",
            "cppStandard": "c++17",
            "intelliSenseMode": "linux-gcc-x64"
        }
    ],
    "version": 4
}

具体原因 #

1. 代码本身的声明顺序不符合C语法规则：全局作用域下声明带尾置返回类型的函数时，返回值用到的类型必须在声明语句之前就可见。你现在把CustomConfigType的定义写在了initConfig声明的后面，实际用g编译这段代码时，首先会抛出‘CustomConfigType’ does not name a type的错误，而非重载相关错误。
2. IntelliSense的解析逻辑存在偏差：解析头文件读到initConfig的声明时，还未识别到后面定义的CustomConfigType，就错误将该函数的签名记录为「参数为(int, char**)、返回值为待推导auto」；等后续解析到CustomConfigType定义、再读到cpp文件里签名正确的initConfig实现时，IntelliSense没有覆盖之前错误存储的函数签名，反而将两个签名判定为同名、同参数列表但返回值不同的非法重载，最终抛出了和实际问题不匹配的重载错误提示。

修复方法 #

调整头文件内的声明顺序即可，两种方案任选：

• 把CustomConfigType的结构体定义挪到initConfig函数声明之前
• 在initConfig声明前加struct CustomConfigType;前向声明

调整完成后执行命令面板里的C/C++: Reset IntelliSense Database重置IntelliSense缓存，错误提示就会消失。

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