编辑“︁C++ 命名空间”︁（章节）

= C++命名空间 =

'''命名空间'''（Namespace）是C++中用于组织代码、避免命名冲突的重要机制。它通过将全局作用域划分为不同的命名区域，允许在不同命名空间中定义相同名称的标识符而不会产生冲突。

== 基本概念 ==

命名空间的核心作用是：
* 防止大型项目中因不同库或模块使用相同标识符导致的命名冲突
* 提高代码可读性和组织性
* 实现逻辑分组，便于代码维护

=== 语法结构 ===
基本命名空间定义语法：
<syntaxhighlight lang="cpp">
namespace 名称 {
    // 声明/定义
    // 变量、函数、类、模板等
}
</syntaxhighlight>

== 命名空间使用 ==

=== 定义命名空间 ===
<syntaxhighlight lang="cpp">
namespace Math {
    const double PI = 3.1415926;
    
    double square(double x) {
        return x * x;
    }
}
</syntaxhighlight>

=== 访问命名空间成员 ===
有三种主要访问方式：

1. '''完全限定名'''（推荐避免冲突）：
<syntaxhighlight lang="cpp">
double area = Math::PI * Math::square(radius);
</syntaxhighlight>

2. '''using声明'''（引入特定符号）：
<syntaxhighlight lang="cpp">
using Math::PI;
double circumference = 2 * PI * radius;
</syntaxhighlight>

3. '''using指令'''（引入整个命名空间）：
<syntaxhighlight lang="cpp">
using namespace Math;
double volume = PI * cube(radius); // 假设cube也在Math中
</syntaxhighlight>

{{Warning|过度使用`using namespace`可能导致命名污染，特别是在头文件中应避免。}}

== 嵌套命名空间 ==

命名空间可以嵌套以实现更精细的组织：
<syntaxhighlight lang="cpp">
namespace Library {
    namespace Graphics {
        class Vector3D { /*...*/ };
    }
    namespace IO {
        class File { /*...*/ };
    }
}
</syntaxhighlight>

C++17引入了更简洁的嵌套语法：
<syntaxhighlight lang="cpp">
namespace Library::Graphics {
    class Matrix4x4 { /*...*/ };
}
</syntaxhighlight>

== 匿名命名空间 ==

匿名命名空间（未命名的命名空间）用于定义仅在当前文件内可见的实体，相当于C风格的`static`声明但更灵活：
<syntaxhighlight lang="cpp">
namespace {
    int internalCounter = 0; // 仅在本文件可见
    
    void logEvent(const std::string& msg) {
        // 内部实现
    }
}
</syntaxhighlight>

== 命名空间别名 ==

为长命名空间创建简短别名：
<syntaxhighlight lang="cpp">
namespace fs = std::filesystem; // C++17文件系统库别名
namespace lc = Library::Core::Version_2_5;

fs::path filePath = fs::current_path();
</syntaxhighlight>

== 实际应用案例 ==

=== 案例1：数学库组织 ===
<mermaid>
graph TD
    Math[Math Namespace] --> Constants[Constants]
    Math --> Algebra[Algebra]
    Math --> Geometry[Geometry]
    Constants --> PI
    Constants --> E
    Algebra --> Polynomial
    Geometry --> Vector
    Geometry --> Matrix
</mermaid>

对应实现：
<syntaxhighlight lang="cpp">
namespace Math {
    namespace Constants {
        constexpr double PI = 3.141592653589793;
        constexpr double E = 2.718281828459045;
    }
    
    namespace Algebra {
        class Polynomial { /*...*/ };
    }
    
    namespace Geometry {
        template<typename T>
        class Vector3D { /*...*/ };
    }
}
</syntaxhighlight>

=== 案例2：游戏引擎模块 ===
<syntaxhighlight lang="cpp">
namespace GameEngine {
    namespace Core {
        class Application { /*...*/ };
    }
    
    namespace Rendering {
        class Shader { /*...*/ };
        namespace Vulkan {
            class Pipeline { /*...*/ };
        }
    }
    
    namespace Physics {
        class RigidBody { /*...*/ };
    }
}

// 使用示例
using namespace GameEngine::Rendering;
Shader* shader = new Shader();
</syntaxhighlight>

== 高级特性 ==

=== 内联命名空间 ===
主要用于版本控制，内联命名空间的成员会被视为直接属于父命名空间：
<syntaxhighlight lang="cpp">
namespace Network {
    inline namespace v1 {
        class Socket { /*...*/ }; // 默认版本
    }
    
    namespace v2 {
        class SecureSocket { /*...*/ }; // 新版本
    }
}

// 使用
Network::Socket sock; // 实际使用v1::Socket
</syntaxhighlight>

=== 命名空间与ADL ===
'''参数依赖查找'''（Argument-Dependent Lookup，又称Koenig查找）规则：
当函数调用中的参数类型属于特定命名空间时，编译器会在该命名空间中查找函数：
<syntaxhighlight lang="cpp">
namespace Custom {
    class Widget {};
    void display(const Widget& w) { /*...*/ }
}

int main() {
    Custom::Widget w;
    display(w); // 无需限定名，通过ADL找到Custom::display
}
</syntaxhighlight>

== 最佳实践 ==

1. 避免在头文件中使用`using namespace`
2. 优先使用完全限定名或`using`声明而非`using`指令
3. 合理使用命名空间组织大型项目
4. 匿名命名空间替代文件作用域的`static`声明
5. 保持命名空间命名简洁但有描述性

{{Tip|在大型项目中，可以采用与目录结构匹配的命名空间层次，提高代码可维护性。}}

== 练习 ==

1. 创建一个命名空间`StringUtils`，包含以下函数：
   - `toUpper()`
   - `toLower()`
   - `trim()`

2. 解释以下代码的输出：
<syntaxhighlight lang="cpp">
#include <iostream>

namespace A {
    void print() { std::cout << "A\n"; }
}

namespace B {
    void print() { std::cout << "B\n"; }
}

int main() {
    using namespace A;
    using namespace B;
    print(); // 会发生什么？
}
</syntaxhighlight>

== 总结 ==

命名空间是C++模块化编程的基础工具，合理使用可以：
* 显著降低命名冲突风险
* 提高代码可读性和组织性
* 支持大型项目的协同开发

随着C++标准演进（如C++20的模块），命名空间仍将保持其核心地位。掌握命名空间的使用是成为专业C++开发者的必备技能。

[[Category:编程语言]]
[[Category:C++]]
[[Category:C++ 基础]]