讲师中心 微信公众号
AI工具推荐 视频效率加速

c++如何使用C++20 Modules模块_c++ import语法与编译速度提升【教程】

胖浩同学_7188

胖浩同学_7188

发布时间:2026-01-01 13:39:43

|

818人浏览过

|

来源于php中文网

原创

import 不会自动找模块文件,因 C++20 Modules 依赖编译器显式预编译接口单元(如 .ixx)生成 PCM 二进制,并通过 -fmodule-file= 等参数指定路径,而非按名查找源文件或头文件。

c++如何使用c++20 modules模块_c++ import语法与编译速度提升【教程】

为什么 import 不会自动找到模块文件

因为 C++20 Modules 不是“按名查找”,而是依赖编译器对模块接口单元(.ixx.cppm)的显式编译与导出。你写 import math_utils;,编译器不会去头文件目录翻 math_utils.h,也不会扫描当前目录找同名文件——它只认已生成的模块二进制(如 math_utils.pcm)且需通过 -fmodule-file=--precompile 显式提供路径。

  • Clang 默认不自动生成或缓存 PCM 文件,每次都要手动预编译接口单元
  • MSVC 要求模块接口单元必须用 /interface 编译,且 import 语句所在 TU 必须用 /reference 指向对应 PCM
  • gcc 13+ 支持有限,仍需 -fmodules-ts + -fmodule-file=,且不支持跨目录隐式解析

如何正确编译一个模块并被其他文件 import

以 Clang 15+ 为例(Linux/macOS),关键在于两步分离:先预编译接口单元,再编译导入单元。

clang++ -std=c++20 -x c++-system-header -fmodules -fimplicit-modules -fmodule-map-file=module.modulemap -c math_utils.ixx -o math_utils.pcm
clang++ -std=c++20 -fmodules -fmodule-file=math_utils.pcm main.cpp -o main

其中:

  • math_utils.ixx 是模块接口单元,含 export module math_utils;export 声明
  • module.modulemap 非必需,但若想让模块名映射到文件路径,需显式声明:
    module "math_utils" { header "math_utils.ixx" isystem "." }
  • -fimplicit-modules 允许自动加载标准库模块(如 import std.core;),但不会帮你找自定义模块

import 后为什么链接失败或符号未定义

模块接口单元(.ixx)只导出声明,不包含实现;实现必须放在模块实现单元(.cpp)中并参与链接。常见错误是只编译了接口单元 PCM,却忘了把对应实现编译进最终可执行文件。

Miller CSV TSV JSON 数据处理器
Miller CSV TSV JSON 数据处理器

Miller (mlr) 是一个命令行工具,用于查询、整形和重新格式化名称索引数据,如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。

下载

立即学习C++免费学习笔记(深入)”;

  • 模块接口单元里 export 的函数,必须在某个 .cpp 文件里有非 inline 定义(除非加 inline 或写在头文件内联区)
  • Clang 下,实现单元仍要用 -fmodules 编译,否则无法识别模块内部符号依赖
  • MSVC 中,模块实现单元必须用 /implementation 编译,且不能同时用 /interface

编译速度提升真实吗?哪些场景反而更慢

模块确实能跳过预处理器、避免重复解析头文件,但提速效果高度依赖项目结构和构建系统配合。实测中,以下情况可能变慢:

  • 小项目( 头文件重用收益
  • 频繁修改接口单元:每次改 .ixx 都触发整个模块 PCM 重建,所有 import 它的文件全量重编
  • CI 环境无模块缓存:PCM 文件未复用,等于每次从零预编译
  • 混合使用传统头文件和模块:编译器需维护两套依赖模型,中间表示膨胀

真正受益的是大型代码库,尤其是接口稳定、实现常变、头文件嵌套深(如 #include <boost/hana.hpp> 这种)的场景。

模块不是银弹,它把“头文件管理复杂度”换成了“PCM 生命周期管理复杂度”。没配好构建脚本前,别指望一键加速。

相关文章

c++速学教程(入门到精通)
c++速学教程(入门到精通)

c++怎么学习?c++怎么入门?c++在哪学?c++怎么学才快?不用担心,这里为大家提供了c++速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

相关专题

更多
硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

3028

2023.10.19

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

4229

2025.10.17

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3649

2025.12.29

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

366

2026.01.19

go中interface用法
go中interface用法

本专题整合了go语言中int相关内容,阅读专题下面的文章了解更多详细内容。

3150

2025.09.10

macOS怎么切换用户账户
macOS怎么切换用户账户

在 macOS 系统中,可通过多种方式切换用户账户。如点击苹果图标选择 “系统偏好设置”,打开 “用户与群组” 进行切换;或启用快速用户切换功能,通过菜单栏或控制中心的账户名称切换;还能使用快捷键 “Control+Command+Q” 锁定屏幕后切换。

3604

2025.05.09

磁盘配额是什么
磁盘配额是什么

磁盘配额是计算机中指定磁盘的储存限制,就是管理员可以为用户所能使用的磁盘空间进行配额限制,每一用户只能使用最大配额范围内的磁盘空间。php中文网为大家提供各种磁盘配额相关的内容,教程,供大家免费下载安装。

3630

2023.06.21

如何安装LINUX
如何安装LINUX

本站专题提供如何安装LINUX的相关教程文章,还有相关的下载、课程,大家可以免费体验。

3153

2023.06.29

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

0

2026.09.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn