C++23中的模块应用说明之一基础分析

原创已于 2025-12-20 09:27:04 修改 · 277 阅读

3 ·

CC 4.0 BY-SA版权

文章标签：

#c++23

于 2025-12-20 09:26:15 首次发布

C++ 同时被 2 个专栏收录

480 篇文章

订阅专栏

C++11

358 篇文章

订阅专栏

一、模块及特点

在前面的c++20分析中就对模块的应用进行过分析和举例，最近的文章中通过对import的应用分析也再次引入了模块的开发。今天将对C++20后的模块开发进行一个初步的分析，从而让大家能够从概念层次上对模块有一个全面学习。
在传统的C++开发中，头文件机制虽然看上去简单，但实际上问题多多。特别是有的情况下，只是简单的把头文件的包含顺序改一下，可能编译就没有问题了。这让很多的开发者感到困惑。同时，头文件的使用也可能引起编译污染，导致很多编译单元进行重新编译，从而大降低了编译的效率。甚至为了降低这种可能，还引入了Pimpl编程机制和类声明机制。另外，头文件引出的命名冲突和宏污染等问题也不可忽视。而在C++20中引入模块机制正是想从根本上解决这种头文件代码组织导入的方式。它可以通过export显式的来控制相关接口的导出，从而让开发变得更可控和安全。
在其它的现代高级语言的开发中，基本都采用了包机制，如Go,Java以及Python等。而C++引入模块机制也是对其的一种致敬吧。

二、模块的应用

模块机制的应用一般来说有以下几部分：

模块单元的接口定义和具体实现
模块的接口负责定义相关的使用约定和条件；实现提供具体的应用逻辑。接口抽象消除对具体应用的依赖，这也符合设计原则上的依赖于抽象，便于扩展和测试。
利用export定义规则限制
模块的一个最主要功能就是要和其它的模块协作，所以可以通过export来确定相关的导出的内容，用来向其它模块或应用提供接口，控制内外的边界。每个模块只有能一个默认的导出，另外，export的应用有着具体的语义规则：模块是静态绑定的且要保持全局引用的一致性；模块作用域内的临时变量不可导出；支持重导出（re-export），目的是聚合接口。
说明，所谓重导出，就是在导出模块中可以导出其它模块。类似下面：

//已存在A，B两个模块,在C模块中导出它们
export module C;
export module A;
export module B;
//有选择的导出即分区导出
export import:A1 from A;//设定A模块中导出了A1模块
export void test();//C模块中自定义的导出接口

文件命名和模块管理
虽然文件的命名没有强制一说，但为了保持可维护性和易用，还是建议使用一些常见的风格管理，如Google、Linux等等，其后缀推荐使用.ccpm或.ixx。没有强制，只有适用。举个例子，以点分隔相关模块就是一种非常容易为大家理解和接受的方法即类似“export math.core.matrix”。
同样，模块管理中，模块的文件最好与实际的定义一一保持对应（一一映射）。这个如果有Go或Python等开发经验的就非常好理解了。
全局模块片段的应用
全局模块片段是c++模块用来兼容传统头文件的一种机制，它不属于模块相关说明。一般位于接口单元中”module;”声明后到模块定义“export module myself;”之前的部分。如下面的示例：

module;
#include <vector>
export module demo;

全局模块片段还可以用来隔绝预处理器的定义，处理宏定义等。
5. 私有模块片段的应用
有全局模块片段就会有私有的。在C++中一般是采用如下的方式定义：

module;
#include <iostream>
export module demo;
module:private;
void testPrivate(){std::cout<<"private module test!"<<std::endl;}

这里需要注意的是，私有模块必须在公有及导出模块模块之后定义，否则会报相关的编译错误。如：

exportdemo.cppm:10:1: error: export declaration cannot be used in a private module fragment
   10 | export int Add(int,int);
      | ^
/qt610_project/cmakeMouduleFirst/exportdemo.cppm:6:1: note: private module fragment begins here
    6 | module:private;
      | ^
/qt610_project/cmakeMouduleFirst/exportdemo.cppm:11:1: error: export declaration cannot be used in a private module fragment
   11 | export class exportDemo
      | ^
/qt610_project/cmakeMouduleFirst/exportdemo.cppm:6:1: note: private module fragment begins here
    6 | module:private;

以上即对模块应用的一个整体的说明，大家可以针对前面的应用进行相关的学习和代码测试。

三、例程

根据上面的分析，下面给出一个具体的例程：

//exportdemo.cppm
module;
#include <vector>
#include <iostream>
export module demo;
import std;

namespace demo{
export int Add(int,int);
export class exportDemo
{
public:
    exportDemo();
public:
    void display();
    std::vector<int> vec_;
};
}

module:private;
void testPrivate(){std::cout<<"private module test!"<<std::endl;}
//exportdemo.cpp
module demo;
import std;
namespace demo{
int Add(int a,int b){return a+b;}
exportDemo::exportDemo() {}
void exportDemo::display(){
    vec_.reserve(10);
    testPrivate();
    std::cout<<"this is demo module!"<<std::endl;
}
}