如何为内部命名空间类创建别名？编译链接报错修复

以下是项目中的代码文件：

platform/common/baseapp.hpp #

#pragma once

#include <string>

namespace platform::common 
{

class BaseApp
{
    public:
        BaseApp(std::string name);
        virtual ~BaseApp() {}
        virtual int run() = 0;
    private:
        std::string m_name;
};

}

platform/common/baseapp.cxx #

#include "baseapp.hpp"

using namespace platform::common;

BaseApp::BaseApp(std::string name):
    m_name(std::move(name))
{
    
}

platform/darwin/app.hpp #

#pragma once

#include <string>

#include "platform/common/baseapp.hpp"

namespace platform::darwin 
{

class DarwinApp: public platform::common::BaseApp 
{
    public:
        DarwinApp(std::string name);
        int run() override;
};

}

platform/darwin/app.cxx #

#include "app.hpp"

using namespace platform::darwin;

DarwinApp::DarwinApp(std::string name):
    BaseApp(std::move(name))
{

}

int DarwinApp::run() {
    return 0;
}

platform/platform.hpp #

#include "flags.hpp"

namespace platform {

#if TARGET_APPLE_MACOS //自定义有效编译标志
    #include "platform/darwin/app.hpp"
    
    typedef platform::darwin::DarwinApp App;
#endif

}

main.cxx #

#include <string>

#include "platform/platform.hpp"

using namespace platform;

int main() {
    App app(std::string("App"));
    return app.run();
}

编译错误信息 #

[build] ld: Undefined symbols:
[build]   platform::platform::darwin::DarwinApp::run(), referenced from:
[build]       _main in main.cxx.o
[build]   platform::platform::darwin::DarwinApp::DarwinApp(std::__1::basic_string<char, std::__1::char_traits<char>, std::__1::allocator<char>>), referenced from:
[build]       _main in main.cxx.o
[build] clang: error: linker command failed with exit code 1 (use -v to see invocation)

修复方案 #

问题根源 #

在platform/platform.hpp中，代码已经处于platform命名空间内部，此时使用platform::darwin::DarwinApp会被编译器解析为platform::platform::darwin::DarwinApp，但实际的DarwinApp类定义在全局命名空间下的platform::darwin中，导致别名App指向了一个不存在的类，最终链接时找不到对应符号。

具体修复 #

修改platform/platform.hpp中的别名定义，二选一即可：

1. 利用当前命名空间，直接引用darwin::DarwinApp：

#include "flags.hpp"

namespace platform {

#if TARGET_APPLE_MACOS
    #include "platform/darwin/app.hpp"
    
    typedef darwin::DarwinApp App;
#endif

}

2. 使用全局命名空间前缀::明确指定路径：

#include "flags.hpp"

namespace platform {

#if TARGET_APPLE_MACOS
    #include "platform/darwin/app.hpp"
    
    typedef ::platform::darwin::DarwinApp App;
#endif

}

额外检查 #

确保构建系统已将platform/darwin/app.cxx加入编译目标，该文件必须被编译并链接到最终可执行文件中，否则也会出现未定义符号错误。

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