C++在Clion中环境搭建详细教程-C++-PHP中文网

c++在clion中环境搭建详细教程

C++在CLion中的环境搭建，说白了，就是确保你的电脑上有一套能编译C++代码的工具链，然后告诉CLion这些工具在哪里。这听起来可能有点绕，但实际上，核心就是“编译器在哪儿？调试器在哪儿？项目构建工具CMake在哪儿？”把这三位爷伺候好了，CLion自然就能开心地工作了。

解决方案

搭建C++环境，我通常会从最基础的工具开始，因为CLion本身只是一个IDE，它需要外部的编译器和构建系统来完成实际的工作。

安装C++编译器与构建系统：
- Windows用户： 我个人偏爱MinGW-w64。你可以去其官网（或通过MSYS2）下载安装。安装时，记得选择合适的架构（通常是
```
x86_64
```
  登录后复制
  ）和线程模型（
```
posix
```
  登录后复制
  或
```
win32
```
  登录后复制
  ，通常
```
posix
```
  登录后复制
  配合
```
seh
```
  登录后复制
  异常处理会比较稳定）。安装路径最好简单一点，比如
```
C:\MinGW
```
  登录后复制
  ，避免路径中出现空格或特殊字符，这能省去很多不必要的麻烦。安装完成后，务必将MinGW的
```
bin
```
  登录后复制
  目录（例如
```
C:\MinGW\bin
```
  登录后复制
  ）添加到系统的环境变量
```
Path
```
  登录后复制
  中。这样，你才能在命令行中直接调用
```
g++
```
  登录后复制
  和
```
gdb
```
  登录后复制
  。
- macOS用户： 最简单的方式是安装Xcode Command Line Tools。在终端里输入
```
xcode-select --install
```
  登录后复制
  ，系统会自动帮你搞定GCC、Clang和Make。
- Linux用户： 大多数发行版都自带或可以通过包管理器轻松安装GCC/Clang。例如，Ubuntu上是
```
sudo apt update && sudo apt install build-essential gdb
```
  登录后复制
  。
- CMake： 现代C++项目几乎离不开CMake。CLion通常会自带一个捆绑的CMake版本，但有时你可能需要安装最新版或特定版本。可以从CMake官网下载安装，同样记得添加到系统
```
Path
```
  登录后复制
  。
配置CLion工具链：

立即学习“C++免费学习笔记（深入）”；
- 启动CLion，进入
```
File -> Settings/Preferences -> Build, Execution, Deployment -> Toolchains
```
  登录后复制
  。
- 点击左上角的
```
+
```
  登录后复制
  号，添加一个新的工具链。如果你是Windows用户，通常会选择
```
MinGW
```
  登录后复制
  或
```
Visual Studio
```
  登录后复制
  ；macOS/Linux用户选择
```
System GCC
```
  登录后复制
  或
```
System Clang
```
  登录后复制
  。
- CLion会尝试自动检测你的编译器、调试器和CMake路径。如果它没能自动找到，你需要手动指定。
  - C Compiler: 指向你的C编译器可执行文件（如
```
C:\MinGW\bin\gcc.exe
```
    登录后复制
    ）。
  - C++ Compiler: 指向你的C++编译器可执行文件（如
```
C:\MinGW\bin\g++.exe
```
    登录后复制
    ）。
  - Debugger: 指向你的调试器可执行文件（如
```
C:\MinGW\bin\gdb.exe
```
    登录后复制
    ）。
  - CMake: 指向你的CMake可执行文件（如
```
C:\Program Files\CMake\bin\cmake.exe
```
    登录后复制
    ）。
  - Make: 对于MinGW，它通常是
```
C:\MinGW\bin\mingw32-make.exe
```
    登录后复制
    ；对于Linux/macOS，就是
```
make
```
    登录后复制
    。
- 确保所有路径都正确无误，CLion会在下方显示“Environment is OK”或类似提示。如果显示错误，仔细检查路径是否正确，或者对应的工具是否真的安装了。
创建或打开C++项目：
- 配置好工具链后，你就可以创建新项目了。选择
```
File -> New Project
```
  登录后复制
  ，然后选择
```
C++ Executable
```
  登录后复制
  。CLion会为你生成一个基本的
```
main.cpp
```
  登录后复制
  和
```
CMakeLists.txt
```
  登录后复制
  文件。
- 如果你打开一个已有的CMake项目，CLion会自动加载
```
CMakeLists.txt
```
  登录后复制
  并尝试配置。

为什么我的CLion总是找不到编译器？

这绝对是初学者最常遇到的问题，没有之一。我记得我刚开始用CLion时，也在这上面卡了很久。通常，CLion找不到编译器，原因无非就那么几个，但排查起来确实需要一点耐心。

首先，最直接的原因是编译器根本没装。听起来很傻，但很多人可能只装了CLion，却忘了装MinGW或者Xcode Command Line Tools。CLion自己是不会带编译器的，它只是一个智能的编辑器和项目管理器。

其次，即便装了，路径问题也是大头。

环境变量没配好：如果你安装了MinGW或者CMake，但是没有把它们的
```
bin
```
登录后复制
目录添加到系统的
```
Path
```
登录后复制
环境变量里，那么系统就不知道
```
g++
```
登录后复制
、
```
gdb
```
登录后复制
或者
```
cmake
```
登录后复制
命令在哪里。CLion在尝试自动检测时，如果系统找不到，它也自然找不到。你可以打开命令行（Win+R输入
```
cmd
```
登录后复制
），然后输入
```
g++ -v
```
登录后复制
或者
```
cmake --version
```
登录后复制
，如果命令不识别，那多半就是
```
Path
```
登录后复制
的问题。
CLion配置路径错误：在
```
Settings/Preferences -> Toolchains
```
登录后复制
里，你可能手动指定了一个错误的路径，比如指向了一个不存在的文件夹，或者指向了
```
gcc.exe
```
登录后复制
的父目录而不是其本身。我见过有人把整个MinGW的根目录填进去，而不是
```
bin
```
登录后复制
目录下的具体可执行文件。CLion需要的是精确到可执行文件的路径。
多个版本冲突：有时你电脑上可能装了多个版本的MinGW或者其他编译器，系统
```
Path
```
登录后复制
里也可能存在多个指向不同版本的路径。CLion在自动检测时，可能会抓到错误的那个，导致一些奇怪的问题。这时候，最好手动在CLion里指定你想要用的那个版本。

最后，CMake配置问题也可能间接导致“找不到编译器”的假象。CLion的C++项目是基于CMake的。如果CMake本身配置有问题，或者

CMakeLists.txt

登录后复制

文件有语法错误，CMake在尝试生成构建文件时就会失败，CLion可能会误报是编译器的问题。这时候，可以尝试在CLion底部的

cmake

登录后复制

工具窗口查看输出日志，那里会有更详细的错误信息。

解决这些问题，我的经验是：先在系统命令行里确认

g++

登录后复制

、

gdb

登录后复制

、

cmake

登录后复制

都能正常运行，然后再去CLion里配置。这样，如果CLion还报错，那问题就基本锁定在CLion的配置界面本身了。

CLion中的CMakeLists.txt到底有什么用？我需要手动修改它吗？

CMakeLists.txt

登录后复制

，在我看来，是CLion管理C++项目的“核心指令集”。它不像Visual Studio那样有

.vcxproj

登录后复制

文件，而是采用了一种更通用、跨平台的构建系统描述语言——CMake。简单来说，

CMakeLists.txt

登录后复制

就是告诉CMake“你的项目里有哪些源文件？需要链接哪些库？编译的时候要用什么标准？输出的文件叫什么名字？”等等。

豆包AI编程

豆包推出的AI编程助手

483

查看详情

它的核心作用在于：

项目结构定义： 它定义了你的项目有哪些可执行文件、库文件，它们分别由哪些源文件组成。
构建规则： 设定了编译选项（如C++标准、警告级别）、链接选项、头文件搜索路径、库文件搜索路径等。
跨平台兼容： 这是CMake最大的优势。你写一份
```
CMakeLists.txt
```
登录后复制
，它就能在Windows、macOS、Linux上，通过不同的编译器（MSVC、GCC、Clang）生成对应的构建系统（Makefile、Ninja、Visual Studio项目文件），实现“一次编写，到处构建”。CLion正是利用这一点来提供统一的开发体验。

我需要手动修改它吗？

答案是：绝对需要，而且是必须的。 对于任何一个稍微复杂一点的C++项目，你都得手动修改

CMakeLists.txt

登录后复制

。CLion在创建项目时会生成一个非常基础的模板，比如：

cmake_minimum_required(VERSION 3.26)
project(MyCppProject)

set(CMAKE_CXX_STANDARD 17)

add_executable(MyCppProject main.cpp)

登录后复制

这个模板只适用于一个

main.cpp

登录后复制

的简单项目。一旦你：

添加了新的源文件（比如
```
utils.cpp
```
登录后复制
、
```
myclass.cpp
```
登录后复制
），你需要把它们加到
```
add_executable
```
登录后复制
命令里：
```
add_executable(MyCppProject main.cpp utils.cpp myclass.cpp)
```
登录后复制
使用了外部库（比如Boost、OpenCV、SDL），你需要告诉CMake去哪里找这些库，并把它们链接到你的可执行文件上。这通常涉及到
```
find_package()
```
登录后复制
和
```
target_link_libraries()
```
登录后复制
：
```
find_package(Boost REQUIRED COMPONENTS system filesystem) # 查找Boost库
target_link_libraries(MyCppProject Boost::system Boost::filesystem) # 链接Boost库
```
登录后复制

需要设置特定的编译宏或定义：

target_compile_definitions(MyCppProject PRIVATE MY_DEBUG_MODE)

登录后复制

需要添加额外的头文件搜索路径：

target_include_directories(MyCppProject PRIVATE ${PROJECT_SOURCE_DIR}/include)

登录后复制

所以，理解并能够修改

CMakeLists.txt

登录后复制

是使用CLion进行C++开发的基础技能。它虽然初看起来有点陌生，但一旦掌握，你会发现它比IDE自带的那些臃肿的项目文件清晰得多，也强大得多。CLion会实时监控

CMakeLists.txt

登录后复制

的变化，并自动重新加载CMake项目，这让修改体验非常流畅。

我应该选择MinGW还是MSVC作为CLion的C++编译器？

这个问题，尤其对于Windows用户来说，是个经典的抉择。在我看来，这没有绝对的对错，更多是取决于你的项目需求、个人习惯以及你对生态系统的偏好。

MinGW (Minimalist GNU for Windows)

优点：
- 开源免费，轻量级： 它基于GCC/G++，对于习惯Linux/macOS上GCC环境的开发者来说，MinGW提供了一个非常相似的开发体验。安装包通常不大，占用资源少。
- 跨平台兼容性好： 如果你的项目目标是跨平台，希望代码在不同操作系统下都能用GCC/Clang编译，那么MinGW是很好的选择，因为它提供了一个类Unix的编译环境。
- 社区活跃： GCC生态系统庞大，有很多开源库和工具都默认支持GCC。
缺点：
- Windows API兼容性： 虽然MinGW可以调用大部分Windows API，但在某些深度与Windows系统集成、或者需要使用COM、ATL等技术的项目上，可能会遇到一些兼容性或便利性问题。
- 调试器： MinGW通常搭配GDB使用。GDB本身非常强大，但在Windows环境下，有时其与IDE的集成体验，或者对某些复杂Windows进程的调试能力，可能不如MSVC的调试器。
- 安装： 相对于MSVC，MinGW的安装和环境变量配置可能需要更多手动步骤。

MSVC (Microsoft Visual C++)

优点：
- 与Windows深度集成： 如果你主要开发Windows桌面应用、游戏（特别是DirectX）、或者需要与.NET、COM等微软技术栈深度互操作，MSVC是毫无疑问的首选。它提供了最佳的Windows API支持和性能。
- 强大的调试器： Visual Studio的调试器是业界公认的顶尖水平，对于Windows平台上的复杂应用调试，它提供了无与伦比的便利性和功能。
- 工具链完整： 随Visual Studio一起安装，整个工具链（编译器、链接器、调试器、性能分析器）高度集成，开箱即用。
缺点：
- 体积庞大： 安装Visual Studio（即使只选择C++桌面开发组件）也需要相当大的硬盘空间和时间。
- 专有性： MSVC是微软的产品，虽然对C++标准的支持越来越好，但它毕竟是一个专有编译器。对于追求完全开源和跨平台一致性的项目，可能不是最佳选择。
- C++标准支持： 过去MSVC在C++标准支持上略滞后于GCC/Clang，但近年来已经迎头赶上，大部分新标准特性都能很好支持。

我的建议：

如果你是C++初学者，或者主要进行算法学习、数据结构、跨平台通用工具开发，并且不涉及太多Windows特定API，那么MinGW-w64是一个非常好的起点。 它轻量、免费，能让你快速上手。
如果你已经知道自己将主要在Windows平台上进行深度开发，特别是游戏开发、GUI应用（MFC/Qt for Windows）、或者需要与现有Windows企业级代码库集成，那么MSVC会是更稳妥、更高效的选择。

CLion对这两种工具链都提供了很好的支持。你甚至可以在同一个CLion安装中配置并切换不同的工具链。所以，不妨都尝试一下，看看哪一个更符合你的开发习惯和项目需求。最终的选择，更多是一种权衡和个人偏好。

以上就是C++在Clion中环境搭建详细教程的详细内容，更多请关注php中文网其它相关文章！