C++自定义字面量定义在单独cpp文件时无法被main函数识别问题

问题原因 #

报错是C++友元查找规则的正常限制：
仅在类内部编写的friend友元声明属于隐式声明，这类函数只有**参数依赖查找（ADL）**能搜索到，普通的全局名字查找是看不到的。而你的自定义字面量运算符入参是内置类型long double，没有关联的自定义类/命名空间，无法触发ADL，因此main函数调用时找不到对应的运算符声明，直接报错。

你之前把实现直接写在main同文件、或者头文件的类作用域外时运行正常，本质是因为这种写法同时完成了运算符的全局声明和实现，普通名字查找可以直接匹配到。

解决方案 #

不需要修改现有.cpp的实现，也不用调整友元声明，只需要在头文件的类定义外额外补充一次该运算符的全局声明即可：

// Test.h 修改后代码
#pragma once
class test
{
    double x;
public:
    explicit test(const double a) : x(a) {};
    // 原有友元声明保持不变
    friend test operator "" _t(long double a);
};

// 新增：类外全局声明自定义字面量运算符
test operator "" _t(long double a);

修改后main函数的调用逻辑完全不用动，编译时main文件引入头文件后就能通过普通名字查找找到运算符声明，链接阶段会自动匹配你在Test.cpp中实现的函数逻辑，完全满足实现与声明分离的封装要求。

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