如何在保持C++头/源文件分离结构的同时统一使用指定命名空间？

完全可以在保留现有文件结构的同时，把所有函数纳入libname命名空间，只需要在头文件和源文件中统一包裹命名空间即可，具体操作如下：

头文件（.hpp）的写法 #

在每个功能头文件中，用namespace libname { ... }包裹所有函数声明、模板定义（如果有的话），同时保留原有的头文件保护宏：

比如include/digitmanip.hpp：

#ifndef DIGITMANIP_HPP
#define DIGITMANIP_HPP

namespace libname {

// 操作数字数位的函数声明
int count_digits(int num);
int reverse_digits(int num);

} // namespace libname

#endif // DIGITMANIP_HPP

再比如include/add.hpp：

#ifndef ADD_HPP
#define ADD_HPP

#include <vector>

namespace libname {

// 容器加法函数声明
int sum_vector(const std::vector<int>& vec);

// 可变参数加法模板
template<typename... Args>
auto add_all(Args&&... args) {
    return (args + ...);
}

} // namespace libname

#endif // ADD_HPP

源文件（.cpp）的写法 #

源文件中同样用namespace libname { ... }包裹函数的实现，直接在命名空间内编写代码即可：

比如src/digitmanip.cpp：

#include "digitmanip.hpp"

namespace libname {

int count_digits(int num) {
    if (num == 0) return 1;
    int count = 0;
    while (num != 0) {
        num /= 10;
        count++;
    }
    return count;
}

int reverse_digits(int num) {
    int reversed = 0;
    while (num != 0) {
        reversed = reversed * 10 + num % 10;
        num /= 10;
    }
    return reversed;
}

} // namespace libname

再比如src/add.cpp：

#include "add.hpp"

namespace libname {

int sum_vector(const std::vector<int>& vec) {
    int total = 0;
    for (int val : vec) {
        total += val;
    }
    return total;
}

// 可变参数模板的实现如果已在头文件定义，此处无需重复编写

} // namespace libname

注意事项 #

• 所有头文件和源文件的命名空间必须保持一致，避免出现命名空间不匹配导致的链接错误。
• 如果需要细分功能，还可以在libname下嵌套子命名空间（比如libname::digit、libname::math），不破坏现有文件结构。
• 头文件保护宏依然要保留，防止重复包含问题。

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