如何在macOS上用CMake编译含C++20模块等特性的项目？

环境要求 #

• Apple Clang 14.0.0+（对应Xcode 14及以上版本）：该版本完全支持C++20模块、范围与视图特性
• CMake 3.25+：CMake对C++20模块的稳定支持从3.25版本开始

项目结构示例 #

cpp20-modules-demo/
├── CMakeLists.txt
└── src/
    ├── main.cpp
    ├── mymodule.cppm  # C++20模块接口文件
    └── mymodule_impl.cpp  # 模块实现文件（可选）

CMakeLists.txt 配置 #

cmake_minimum_required(VERSION 3.25)
project(Cpp20ModuleDemo LANGUAGES CXX)

# 强制启用C++20标准，禁用编译器扩展
set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_CXX_EXTENSIONS OFF)

# Apple Clang 专属配置：校验版本并显式开启模块支持
if(CMAKE_CXX_COMPILER_ID STREQUAL "AppleClang")
  if(CMAKE_CXX_COMPILER_VERSION VERSION_LESS "14.0.0")
    message(FATAL_ERROR "需要Apple Clang 14.0.0+以支持C++20模块")
  endif()
  add_compile_options(-fmodules)
endif()

# 创建可执行目标
add_executable(demo)

# 添加普通源文件
target_sources(demo PRIVATE src/main.cpp)

# 添加C++20模块接口文件（FILE_SET CXX_MODULES 是CMake 3.25+的标准写法）
target_sources(demo PRIVATE
  FILE_SET CXX_MODULES
  BASE_DIRS src
  FILES src/mymodule.cppm
)

# 添加模块实现文件（如果有的话）
target_sources(demo PRIVATE src/mymodule_impl.cpp)

模块与主程序示例 #

模块接口文件（src/mymodule.cppm）

export module mymodule;

import <vector>;
import <ranges>;
import <iostream>;

export namespace my_utils {
  // 使用C++20范围视图实现偶数过滤
  auto filter_evens(const std::vector<int>& input) {
    return input | std::views::filter([](int num) { return num % 2 == 0; });
  }

  void print_even_numbers(const std::vector<int>& input) {
    for (int num : filter_evens(input)) {
      std::cout << num << " ";
    }
    std::cout << "\n";
  }
}

主程序文件（src/main.cpp）

import mymodule;
import <vector>;

int main() {
  std::vector<int> numbers = {1, 2, 3, 4, 5, 6, 7, 8};
  my_utils::print_even_numbers(numbers);
  return 0;
}

编译与运行步骤 #

1. 创建并进入构建目录：

mkdir build && cd build

2. 配置CMake（以Xcode为例，也可使用Ninja等生成器）：

cmake .. -GXcode

3. 编译项目：

cmake --build . --config Release

4. 运行程序：

./Release/demo

输出结果：2 4 6 8

注意事项 #

• 模块文件扩展名优先使用.cppm，这是C++标准规定的模块接口文件扩展名，CMake可自动识别
• 若遇到模块缓存问题，直接删除整个build目录后重新配置编译即可
• Apple Clang 14+已原生支持<ranges>和<views>，无需额外添加编译选项或补丁

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