1. 为什么2020.1.3这个版本值得单独拿出来说CLion 2020.1.3 这个版本在 C/C 开发圈子里其实是个挺特殊的存在。2020 年那会儿 JetBrains 刚把 CLion 的 CMake 工具链支持做了一次比较大的重构2020.1 系列引入了对CMake Presets的早期支持、改进了远程开发模式下的工具链同步逻辑还优化了 Windows 下 MinGW 和 MSVC 的自动探测机制。而 2020.1.3 作为这个系列的第三个补丁版本修掉了前两个小版本里几个比较烦人的 bug比如 CMake 重新加载时偶发的索引卡死、以及 Windows 下中文路径导致的编译器探测失败问题。所以如果你现在手上还留着这个版本的安装包或者因为某些历史项目必须锁死在这个版本上那这篇内容就是写给你的。我会把 Win10 下从下载安装到工具链配置、再到第一个可编译可调试项目的完整流程拆开讲重点放在工具链选型逻辑、环境变量与路径的坑、以及CMake 配置里那些文档不会告诉你的细节上。适合谁看如果你是刚接触 C/C 开发、第一次在 Windows 上配 CLion 的新手这篇能让你少走至少两小时的弯路如果你是从 Visual Studio 或者 VS Code 转过来的老手里面关于 MinGW-w64 版本匹配和 CMake 生成器选择的部分也值得扫一眼因为 CLion 的构建模型和那两者差别不小。先说清楚一个前提CLion 本身不包含编译器它只是一个 IDE 外壳真正干活的是你系统里的工具链。这一点和 Visual Studio 那种全家桶思路完全不同。所以整个配置过程的核心其实就是把一套可用的工具链正确地暴露给 CLion。理解了这句话后面所有步骤你都能自己想明白为什么这么做。2. 安装前的准备工作与工具链选型2.1 先决定用哪套编译器MinGW-w64 还是 MSVC这是整个配置流程里第一个、也是最关键的一个决策点。CLion 在 Windows 上主要支持两类工具链工具链类型代表实现优点缺点适用场景MinGW-w64GCC 移植版跨平台一致性好命令行友好配置透明需要手动下载配置调试器需额外准备学习、跨平台项目、开源项目MSVCVisual Studio 编译器与 Windows 深度集成性能优化好依赖 VS 安装命令行环境复杂Windows 原生开发、游戏、商业项目ClangLLVM 工具链错误提示友好编译速度快Windows 下生态相对弱追求编译体验的开发者我个人的建议是如果你是初学者或者做跨平台项目直接上 MinGW-w64。原因很简单它的目录结构清晰环境变量配置直观出问题了容易排查。MSVC 那套vcvarsall.bat的环境注入机制对新手来说是个黑盒一旦 CLion 探测不到就容易抓瞎。这里有个很多人踩过的坑不要用 Dev-C 或者 Code::Blocks 自带的那个老掉牙的 MinGW。那些通常是 32 位的、GCC 版本停留在 4.9 甚至更早对 C14/17 的支持都不完整。CLion 2020.1.3 对工具链的最低要求是 GCC 4.8 以上但实际用起来建议至少 GCC 8.1否则 CMake 的一些现代特性会报错。2.2 MinGW-w64 的下载与版本选择MinGW-w64 的发行版有好几个来源我推荐用MSYS2来管理或者直接下载独立构建包。独立构建包的好处是解压即用不依赖包管理器。选择构建包时看三个参数架构x86_6464位还是i68632位。现在一律选x86_64除非你有明确的 32 位需求。线程模型posix还是win32。选 posix因为 C 标准库的std::thread、std::mutex这些依赖 posix 线程模型才能正常工作。选 win32 的话多线程代码会编译失败。异常模型seh还是sjlj。64 位下选seh性能更好32 位只能用sjlj。所以一个典型的文件名长这样x86_64-8.1.0-release-posix-seh-rt_v6-rev0。看到posix和seh就对了。注意下载下来的通常是 7z 压缩包解压路径不要带中文、不要带空格。我见过太多因为路径里有空格导致 CMake 解析失败的案例。建议直接解压到C:\mingw64这种干净路径。2.3 环境变量的正确配置方式解压完之后需要把C:\mingw64\bin加到系统 PATH 里。操作路径是此电脑右键 → 属性 → 高级系统设置 → 环境变量 → 系统变量里的 Path → 新建 → 填入C:\mingw64\bin。这里有个细节加完之后一定要重开命令行窗口因为 PATH 是在进程启动时读取的已经开着的 cmd 或 PowerShell 不会自动刷新。验证是否成功打开新的 cmd 输入gcc --version g --version gdb --version三条命令都能输出版本信息说明工具链就绪。如果gdb报不是内部或外部命令那说明你的 MinGW 包里没带 gdb需要单独去下载对应版本的 gdb 调试器解压后把bin目录也加进 PATH。实操心得我习惯把 MinGW 的路径同时加到用户变量和系统变量里。系统变量保证所有用户都能用用户变量方便我自己在 PowerShell 里做临时覆盖测试。虽然有点冗余但排查问题时很省事。3. CLion 2020.1.3 的安装与首次启动配置3.1 安装过程中的几个选项CLion 的安装包是个标准的 exe双击一路下一步就行。但有两个地方值得停一下第一是安装路径。默认会装到C:\Program Files\JetBrains\CLion 2020.1.3这个没问题。但如果你的 C 盘空间紧张可以改到其他盘。注意路径同样不要有中文。第二是安装向导最后那几个勾选项Create Desktop Shortcut建议勾上方便启动。Update PATH variable这个可选勾上之后可以在命令行用clion命令启动。但 2020.1.3 这个版本的 PATH 注入有时候会失败勾不勾影响不大。.cpp / .c 文件关联如果你不打算用 CLion 打开所有 C/C 文件可以不勾避免和 VS Code 抢默认打开方式。3.2 首次启动的导入设置与主题选择第一次启动 CLion 会问你是否导入之前的设置。如果是全新安装选Do not import settings。如果你之前装过其他 JetBrains 的 IDE比如 PyCharm、IntelliJ可以选择导入这样快捷键和主题能保持一致。主题选择上2020.1.3 提供了 Darcula暗色和 Light亮色两套。这个纯看个人喜好但我要提一句暗色主题在长时间写代码时对眼睛更友好尤其是晚上。选完之后可以在File → Settings → Appearance Behavior → Appearance里随时切换。3.3 许可证与启动模式CLion 是商业软件但有几种合法使用方式学生认证免费、开源项目申请免费、30 天试用、或者购买授权。启动时会让你登录 JetBrains 账号或者输入激活码。如果你只是临时用一下选Evaluate for free进入 30 天试用。试用期内的功能是完全的没有任何阉割。注意不要在启动阶段纠结太久这些设置后面都能改。先把 IDE 跑起来工具链配好才是正事。4. 工具链配置让 CLion 找到你的编译器4.1 进入 Toolchains 设置界面启动后第一件事打开File → Settings → Build, Execution, Deployment → Toolchains。这是整个配置流程的核心界面。2020.1.3 默认会尝试自动探测系统里的工具链。如果你前面 PATH 配好了这里应该能看到一个自动检测出来的 MinGW 条目名字可能叫MinGW或者Bundled MinGW。但自动探测经常不靠谱尤其是你装了多个编译器的时候。所以我的习惯是不管它探测到没有都手动建一个。4.2 手动配置 MinGW 工具链的每个字段点击左上角的号选择MinGW然后逐个填Name随便起比如MyMinGW。Toolset这是关键。点右边的文件夹图标定位到C:\mingw64注意是根目录不是 bin 目录。CLion 会自动去这个目录下找bin\gcc.exe、bin\g.exe等。C Compiler应该自动填成C:\mingw64\bin\gcc.exe。C CompilerC:\mingw64\bin\g.exe。DebuggerC:\mingw64\bin\gdb.exe。如果这里是空的或者红的说明你的 MinGW 包里没有 gdb需要单独补上。填完之后下面会显示检测到的版本信息比如gcc 8.1.0、gdb 8.1。如果版本号显示出来了说明配置成功。如果显示Not found检查路径是不是填错了或者文件是不是真的存在。4.3 把工具链设为默认配置好之后把这个工具链用右边的上下箭头移到最上面或者点击Default让它变成默认。CLion 会优先使用排在最前面的工具链。这里有个隐藏的坑CMake 和工具链是绑定的。如果你后面切换了工具链需要重新加载 CMake 项目否则用的还是旧工具链。切换方式是Tools → CMake → Reset Cache and Reload Project。实操心得我一般会保留两个工具链配置一个 MinGW 一个 MSVC通过拖动排序来切换。这样测试跨编译器兼容性的时候特别方便不用每次都重新填路径。5. CMake 配置与第一个可运行项目5.1 CMake 在 CLion 里的角色CLion 和很多 IDE 不一样它强依赖 CMake 作为构建系统。你新建项目时CLion 会自动生成一个CMakeLists.txt这个文件描述了项目怎么编译、链接哪些库、生成什么目标。2020.1.3 内置了 CMake 的二进制包所以你不需要单独安装 CMake。但如果你想用自己装的更新版本可以在Settings → Build, Execution, Deployment → CMake里指定。5.2 新建项目的完整流程File → New Project会弹出项目类型选择。选C Executable然后Location项目存放路径同样避免中文和空格。Language standard选C17或者C14。2020.1.3 对 C20 的支持还不完整不建议选。Toolchain确认选的是你刚配好的那个 MinGW。点 Create 之后CLion 会自动生成main.cpp和CMakeLists.txt并开始第一次 CMake 配置。这个过程会在底部状态栏显示进度第一次会比较慢因为要扫描工具链、生成缓存。5.3 读懂自动生成的 CMakeLists.txt自动生成的文件大概长这样cmake_minimum_required(VERSION 3.16) project(untitled) set(CMAKE_CXX_STANDARD 17) add_executable(untitled main.cpp)逐行解释cmake_minimum_required(VERSION 3.16)声明需要的 CMake 最低版本。2020.1.3 内置的是 CMake 3.16.x所以这里写 3.16。project(untitled)项目名会影响到生成的可执行文件名。set(CMAKE_CXX_STANDARD 17)设置 C 标准为 17。add_executable(untitled main.cpp)定义一个可执行目标名字叫untitled源文件是main.cpp。这里有个新手常犯的错误手动往项目里加了新的.cpp文件但忘了在add_executable里加上结果编译报未定义的引用。记住CMake 不会自动扫描源文件你必须显式列出。5.4 构建、运行与调试的完整链路配置完成后右上角会出现运行配置下拉框默认是untitled。点绿色的锤子图标是构建点绿色的三角是运行点绿色的小虫子是调试。构建成功后可执行文件会生成在cmake-build-debug目录下。这个目录是 CLion 自动创建的不要手动改里面的东西也不建议提交到版本控制。调试的时候在代码行号旁边点一下就能下断点然后点调试按钮程序会停在断点处你可以查看变量、调用栈、内存。2020.1.3 的调试器前端做得挺成熟基本能对标 Visual Studio 的体验。注意如果调试时提示During startup program exited with code 0xc0000135这通常是缺少运行时 DLL。MinGW 编译出来的 exe 依赖libgcc_s_seh-1.dll、libstdc-6.dll、libwinpthread-1.dll这几个文件。解决办法是把C:\mingw64\bin加到 PATH你已经做了或者在 CMake 里加-static链接选项静态编译。6. 常见问题排查与避坑经验实录6.1 工具链探测失败的三类原因第一类路径问题。最常见的就是 MinGW 解压路径带空格或中文。CMake 在解析路径时对空格的处理很脆弱C:\Program Files\mingw64这种路径十有八九会出问题。解决方法是换个干净路径。第二类文件缺失。有些精简版的 MinGW 包不带 gdb或者不带mingw32-make.exe。CLion 需要make来驱动构建如果缺了会报错。检查C:\mingw64\bin下有没有mingw32-make.exe没有的话需要补装。第三类版本不兼容。GCC 版本太低低于 4.8会导致 CMake 配置失败。升级到 8.1 以上基本能解决。6.2 CMake 报错的快速定位方法CMake 报错信息通常很长但关键信息在最后几行。看CMake Error开头的部分以及它提到的具体文件和行号。常见的几类错误错误信息关键词含义解决方法Could not find CMAKE_C_COMPILER找不到 C 编译器检查工具链配置No CMAKE_CXX_COMPILER could be found找不到 C 编译器同上确认 g.exe 路径CMake Error: The source directory does not exist源目录不存在检查项目路径Target xxx links to target yyy but the target was not found链接库找不到检查 find_package 和 target_link_libraries6.3 中文乱码与控制台输出问题Windows 控制台默认是 GBK 编码而 MinGW 编译出来的程序默认输出 UTF-8两者不一致就会乱码。解决办法有两个一是在代码里设置SetConsoleOutputCP(65001)把控制台切到 UTF-8。二是在 CMake 里加编译选项-fexec-charsetGBK让程序输出 GBK。我一般用第一种因为不影响跨平台。但要注意SetConsoleOutputCP是 Windows API需要#include windows.h。6.4 调试器无法启动的排查清单调试启动失败按这个顺序查gdb 是否在工具链里正确配置。程序是否成功编译先点构建看有没有报错。杀毒软件是否拦截了 gdb某些安全软件会误报。项目路径是否有中文或特殊字符。是否缺少运行时 DLL前面提到的 0xc0000135。实操心得我遇到过一次 gdb 启动卡死排查了半天发现是杀毒软件的实时防护在扫描 gdb 进程。把项目目录和 MinGW 目录加到白名单就好了。这种问题最恶心因为报错信息完全不相关。6.5 索引卡顿与内存占用优化CLion 基于 IntelliJ 平台索引和代码分析比较吃内存。2020.1.3 默认的 JVM 堆内存可能不够大项目会卡。调整方法Help → Edit Custom VM Options修改-Xmx参数。默认可能是-Xmx2048m可以调到-Xmx4096m前提是你机器内存够。改完重启 IDE 生效。另外cmake-build-debug目录会被索引如果里面文件很多会拖慢速度。可以在Settings → Directories里把它标记为 Excluded。7. 让环境更顺手的几个进阶设置7.1 代码风格与格式化配置Settings → Editor → Code Style → C/C里可以配置缩进、空格、换行等规则。我习惯把缩进改成 4 空格指针符号靠左int* p而不是int *p这样和大多数开源项目的风格一致。配置好之后用CtrlAltL可以一键格式化当前文件。这个快捷键我每天要按几十次。7.2 快捷键方案的选择Settings → Keymap里可以选预设方案。从 VS 转过来的选Visual Studio从 Eclipse 转的选Eclipse习惯 JetBrains 默认的选Default。我个人建议直接用 Default因为 CLion 的很多功能比如ShiftShift全局搜索、AltEnter快速修复在默认方案下最顺手换成其他方案反而会丢失一些映射。7.3 外部工具与终端集成Settings → Tools → Terminal里可以配置内置终端用哪个 shell。默认是 PowerShell但我建议改成cmd或者 Git Bash因为 PowerShell 的某些转义规则和 CMake 命令不兼容。另外可以配置 External Tools把常用的命令行操作比如git status、cmake --build做成菜单项一键调用。7.4 版本控制的基本接入CLion 内置了 Git 支持。Settings → Version Control → Git里指定git.exe路径然后在项目根目录git initIDE 就会自动识别。提交的时候cmake-build-debug目录应该加到.gitignore里因为它是构建产物不应该进版本库。CLion 新建项目时通常会自动生成.gitignore但有时候会漏需要手动检查。8. 关于这套配置后续能怎么扩展工具链配好之后其实只是起点。你可以在这个基础上做很多事情比如接入 Conan 或者 vcpkg 来管理第三方库配置 Google Test 做单元测试或者用 CLion 的远程开发功能把编译放到另一台性能更强的机器上。2020.1.3 这个版本对远程开发的支持已经比较成熟了配置方式是Settings → Build, Execution, Deployment → Toolchains里新建一个Remote Host类型的工具链填上目标机器的连接信息CLion 会自动把源码同步过去、在远端编译、再把结果拉回来调试。这个功能在做嵌入式或者跨平台开发时特别有用。我自己在实际操作中的体会是环境配置这件事一次配好、写成文档比每次重装都重新踩坑要划算得多。我现在维护着一个自己的setup-notes.md里面记录了每个工具链的版本、路径、以及遇到过的坑和解决办法。每次换机器或者重装系统照着文档走一遍半小时就能恢复完整开发环境。最后再分享一个小技巧CLion 的配置目录在C:\Users\你的用户名\AppData\Roaming\JetBrains\CLion2020.1里面保存了所有的设置、快捷键、插件。换机器的时候把这个目录拷过去能省掉大量重复配置的时间。但要注意如果目标机器的 CLion 版本不一样配置可能不兼容最好同版本迁移。