C++中与全局结构体statx同名的匿名命名空间函数编译报错原因求解

核心原因 #

这个问题本质是C++的名称查找规则、匿名命名空间的实现逻辑、同作用域名称隐藏规则共同导致的：

1. 匿名命名空间的名称注入规则 #

C++标准规定，匿名命名空间内定义的名称，编译器会自动在该翻译单元的全局作用域添加一条隐式的using namespace 匿名命名空间唯一别名;指令，相当于把匿名命名空间的名字导入到全局作用域参与非限定名称查找。
这时候你的全局作用域下同时存在两个名称完全相同的实体：

• 全局定义的struct statx（类型名）
• 从匿名命名空间导入的statx()函数（非类型名）
  当你在main里直接写statx()时，普通名称查找会同时找到这两个候选，二者没有优先级差异，所以编译器直接报歧义错误。
  而::statx()是明确查找全局作用域下的原生定义名称，匿名命名空间的statx()本身并不属于全局作用域，只是被导入到全局参与非限定查找，所以限定查找只能找到全局的struct statx，自然就会调用结构体构造函数，而非你想要的函数。

2. static全局函数版本正常的原因 #

C++有一条特殊的名称隐藏规则：同一作用域下，非类型名（函数、变量等）会隐藏同名的类型名（struct、class、enum等）。
你用static修饰的statx()本身就定义在全局作用域，属于非类型名，直接把同作用域的struct statx类型名隐藏了，所以不管你写statx()还是::statx()，名称查找只会找到函数，不存在歧义，自然可以正常编译运行。

适配方案 #

如果你的场景就是要自定义statx系统调用的实现，直接用static修饰全局函数就完全满足需求，既保证了函数的内部链接性（不会和其他翻译单元的同名符号冲突），又避开了名称歧义问题。
如果一定要用匿名命名空间实现，也可以通过显式声明的方式消除歧义：

#include <iostream>
struct statx {};
namespace {
void statx() { std::cout << "Function statx()\n"; }
}
// 显式把匿名命名空间的statx标记为全局优先查找的非类型名，触发名称隐藏规则
using ::statx;
int main()
{
    statx(); // 正常调用匿名命名空间的函数
}

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