clion本身不带gcc,必须手动配置:windows推荐使用内置mingw-w64 13.1(开箱即用),macos需brew install gcc并指定gcc-14等完整路径,linux须确保path正确且从终端启动clion。

CLion 本身不带 GCC,必须手动配置可用的 GCC 编译器,否则新建 C/C++ 项目会直接报错 Cannot find compiler 或构建失败。Windows、macOS 和 Linux 路径与安装方式差异大,不能一概而论。
Windows 下用 MinGW-w64(推荐捆绑版)
CLion 2022.3 及之后版本默认自带 MinGW-w64 工具链(MinGW-w64 13.1),无需额外下载安装,开箱即用:
- 首次新建项目时,IDE 会自动弹出工具链配置页;选中
MinGW,Toolset下拉框里默认就是Bundled MinGW - 若没弹出,手动进入
File → Settings → Build, Execution, Deployment → Toolchains,点+添加,选择MinGW - 确认
C Compiler显示为gcc.exe(路径类似clion\bin\mingw\bin\gcc.exe),C++ Compiler为g++.exe - 调试器建议保持默认的
Bundled GDB,它已预编译并含 Python 支持,能正常渲染 STL 容器
手动安装 MinGW-w64(如需特定版本或 32 位支持)时,注意:选 x86_64 架构、seh 异常模型、win32 线程模型;安装后必须把 bin/ 目录加进系统 Path,否则 CLion 检测不到。
macOS 上用 Homebrew 安装 GCC 并指向正确路径
macOS 自带的 clang 不是 GCC,CLion 项目若依赖 GNU 扩展(如 __attribute__((packed)) 或某些内联汇编),必须显式配置 GCC:
- 先运行
brew install gcc;Homebrew 默认安装多版本(如gcc-14),实际二进制名带版本号 - 用
ls /opt/homebrew/bin/gcc*(Apple Silicon)或ls /usr/local/bin/gcc*(Intel)确认真实路径,常见为gcc-14、g++-14 - 在 CLion 的
Settings → Toolchains中,C Compiler填完整路径,例如/opt/homebrew/bin/gcc-14;C++ Compiler填/opt/homebrew/bin/g++-14 - 不要填
gcc软链接——Homebrew 的gcc默认指向clang,会导致静默编译失败
若执行 brew install gcc 报权限错误,先运行 xcode-select --install;若卡在下载,换清华源:git -C $(brew --repo) remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git。
Linux 或远程开发:GCC 已存在但 CLion 找不到
Linux 发行版通常预装 GCC,但 CLion 可能因 PATH 隔离或 shell 初始化脚本未加载而检测失败:
- 终端中运行
which gcc和gcc --version确认可用;若返回空,说明未安装,用sudo apt install build-essential(Ubuntu/Debian)或sudo dnf groupinstall "Development Tools"(Fedora)补全 - CLion 启动方式很重要:不要从桌面图标或快捷方式启动,而是从已加载环境变量的终端中运行
clion.sh,否则PATH不继承 - 在
Toolchains设置中,Shell path可设为/bin/bash,勾选Run in shell,确保读取~/.bashrc中的环境变量 - 若用 WSL,确保 Windows 端未设置冲突的
PATH(尤其含 Windows MinGW 路径),否则 CLion 可能误选错编译器
远程开发(如连虚拟机)时,GCC 必须装在目标机器上,且 CLion 的 Toolchain 类型要选 Remote Host,SSH 连通后自动同步路径,别手填本地路径。
验证和常见失败信号
配置完别急着写代码,先做最小验证:
- 新建空
C Executable项目,生成默认main.c,点击右上角Build按钮;成功则输出栏出现[Finished],无红色错误 - 若报
gcc: error trying to exec 'cc1': execvp: No such file or directory,说明 GCC 安装不完整(缺libgcc或gcc-g++包),重装 MinGW-w64 或brew reinstall gcc - 若 Debug 按钮灰掉,检查
Debugger是否设为GDB,且路径指向gdb(不是lldb);macOS 上 Homebrew 安装的 GDB 需手动签名才能调试,不如直接用 CLion 捆绑版 - 项目里 CMakeLists.txt 修改后,记得点右上角
Reload CMake project图标,否则旧配置仍生效
最易被忽略的是:CLion 的 Toolchain 是按项目设置的,不是全局;切换项目后可能又回到未配置状态,每次新建项目都得确认一遍。











