cmake指定编译器

在使用 CMake 构建项目时，可以通过多种方式指定编译器。以下是详细的配置方法，包括命令行参数、环境变量和 CMakeLists.txt 文件中的设置。

​​1. 通过命令行指定编译器​​

在运行 cmake 命令时，可以通过 -D 参数或直接指定编译器路径来覆盖默认编译器。

​​(1) 指定 C 和 C++ 编译器​​

cmake -DCMAKE_C_COMPILER=/path/to/gcc -DCMAKE_CXX_COMPILER=/path/to/g++ ..

• ​​示例​​（Linux/macOS）：cmake -DCMAKE_C_COMPILER=gcc-11 -DCMAKE_CXX_COMPILER=g++-11 ..
• ​​示例​​（Windows，使用 MinGW）：cmake -DCMAKE_C_COMPILER="C:/MinGW/bin/gcc.exe" -DCMAKE_CXX_COMPILER="C:/MinGW/bin/g++.exe" ..

​​(2) 直接指定编译器路径（CMake 会自动识别）​​

如果编译器在 PATH 中，可以直接指定名称：

cmake -DCMAKE_C_COMPILER=gcc -DCMAKE_CXX_COMPILER=g++ ..

​​2. 通过环境变量指定编译器​​

CMake 会优先检查环境变量 CC 和 CXX 来确定编译器。

​​(1) 设置环境变量​​

​​Linux/macOS（Bash/Zsh）​​

export CC=/path/to/gcc
export CXX=/path/to/g++
cmake ..

​​Windows（CMD/PowerShell）​​

set CC=C:\MinGW\bin\gcc.exe
set CXX=C:\MinGW\bin\g++.exe
cmake ..

或（PowerShell）：

$env:CC = "C:\MinGW\bin\gcc.exe"
$env:CXX = "C:\MinGW\bin\g++.exe"
cmake ..

​​3. 在 CMakeLists.txt 中指定编译器​​

虽然不推荐（因为会硬编码编译器路径），但可以在 CMakeLists.txt 中强制指定编译器：

# 强制指定编译器（不推荐，除非有特殊需求）
set(CMAKE_C_COMPILER "/path/to/gcc")
set(CMAKE_CXX_COMPILER "/path/to/g++")

⚠️ ​​注意​​：这种方式会覆盖命令行和环境变量的设置，可能导致跨平台兼容性问题。

​​4. 指定编译器生成器（Generator）​​

CMake 支持多种构建系统（如 Makefile、Ninja、Visual Studio 等），可以通过 -G 参数指定生成器，某些生成器会自动选择默认编译器。

​​(1) 指定生成器（Linux/macOS）​​

cmake -G "Unix Makefiles" -DCMAKE_C_COMPILER=gcc -DCMAKE_CXX_COMPILER=g++ ..

​​(2) 指定生成器（Windows，Visual Studio）​​

cmake -G "Visual Studio 17 2022" -A x64 ..

• -A x64 表示生成 64 位项目（可选 Win32 表示 32 位）。

​​(3) 指定生成器（Windows，Ninja）​​

cmake -G "Ninja" -DCMAKE_C_COMPILER=cl -DCMAKE_CXX_COMPILER=cl ..

⚠️ ​​注意​​：在 Windows 上使用 Ninja 时，通常需要配合 Visual Studio 的 MSVC 编译器（cl.exe）。

​​5. 检查当前使用的编译器​​

在配置完成后，可以通过以下命令检查 CMake 实际使用的编译器：

cmake --build . --verbose  # 查看构建日志中的编译器调用

或直接查看 CMakeCache.txt 文件中的相关变量：

grep -E "CMAKE_C_COMPILER|CMAKE_CXX_COMPILER" CMakeCache.txt

​​6. 常见问题与解决方案​​

​​(1) 编译器未找到​​

• ​​错误提示​​：Could NOT find compiler: No such file or directory
• ​​解决方法​​：
  • 确保编译器路径正确，并已添加到 PATH 环境变量。
  • 使用绝对路径指定编译器（如 /usr/bin/gcc 或 C:\MinGW\bin\gcc.exe）。

​​(2) 多版本编译器冲突​​

• ​​问题​​：系统中有多个版本的 GCC/G++，CMake 选择了错误的版本。
• ​​解决方法​​：
  • 显式指定完整路径：cmake -DCMAKE_C_COMPILER=/usr/bin/gcc-11 -DCMAKE_CXX_COMPILER=/usr/bin/g++-11 ..
  • 或通过 update-alternatives（Linux）切换默认版本：sudo update-alternatives --config gcc sudo update-alternatives --config g++

​​(3) Windows 上 MSVC 编译器未识别​​

• ​​问题​​：未安装 Visual Studio 或未正确配置开发环境。
• ​​解决方法​​：
  • 安装 Visual Studio Build Tools。
  • 确保以开发者命令行（Developer Command Prompt）运行 CMake，其中已配置 cl.exe 的路径。

​​7. 完整示例​​

​​Linux/macOS（GCC）​​

# 安装 GCC（如未安装）
sudo apt install gcc g++  # Ubuntu/Debian
sudo yum install gcc gcc-c++  # CentOS/RHEL

# 指定编译器并生成 Makefile
cmake -DCMAKE_C_COMPILER=gcc-11 -DCMAKE_CXX_COMPILER=g++-11 -B build
cmake --build build

​​Windows（Visual Studio）​​

:: 使用 Visual Studio 2022 生成器
cmake -G "Visual Studio 17 2022" -A x64 -B build
cmake --build build

​​Windows（MinGW + Ninja）​​

:: 安装 MinGW 和 Ninja
choco install mingw ninja  # 使用 Chocolatey

:: 指定编译器和生成器
cmake -G "Ninja" -DCMAKE_C_COMPILER="C:\MinGW\bin\gcc.exe" -DCMAKE_CXX_COMPILER="C:\MinGW\bin\g++.exe" -B build
cmake --build build