C++ 项目初始化指北

Tldr

在 Linux 下通过 cmake 与 Conan 进行 C++ 项目初始化与开发的一份简单指北

重要更新

其实目前也可以通过一个模板项目，例如 ModernCppStarter 来生成一个新项目，然后用 AI 帮助更改 CMakeLists.txt 即可，这种方法可能更适合新手（如果你对 AI 发出了正确清晰的命令）

环境准备

首先，我们需要下载以下软件：

1. cmake
2. make 或者 ninja
3. python3
4. pip 或者 pipx
5. clang 系列工具： clangd, clang(++), clang-format, clang-tidy
6. cppcheck

需要注意的是，CMake 的版本最好在 3.27 以上，可以根据 此教程 来安装最新版本的 CMake，目前的最新版本是 3.31

关于 clang 工具链的版本，可以根据 此教程 进行安装

软件安装

我们采用 cmake-init 来进行项目的初始化，并使用 Conan2 来作为包管理器，首先，我们通过 pip 安装：

Terminal window

1
pip install conan cmake-init

在正式开始初始化项目前，我们需要先初始化包管理器 Conan2：

Terminal window

1
conan profile detect --force

项目初始化

使用以下命令初始化一个名为 demo 的项目：

Terminal window

1
cmake-init demo

经过一系列选择，我们得到的文件树如下：

1
.
2
├── build
3
├── cmake
4
├── conan
5
├── docs
6
│   └── pages
7
├── source
8
└── test
9
    └── source

在初始化时，如果包管理器选择为 Conan，那么会生成一个 conanfile.py ，里面描述了依赖的包：

1
from conan import ConanFile
2

3

4
class Recipe(ConanFile):
5
    settings = "os", "compiler", "build_type", "arch"
6
    generators = "CMakeToolchain", "CMakeDeps", "VirtualRunEnv"
7

8
    def layout(self):
9
        self.folders.generators = "conan"
10

11
    def requirements(self):
12
        self.requires("fmt/11.0.2")
13

14
    def build_requirements(self):
15
        self.test_requires("catch2/3.7.0")

我们首先安装这些包，使用命令：

Terminal window

1
conan install . -s build_type=Debug -b missing

随后，Conan 会生成一个文件夹 conan，并在其中生成一系列 .cmake 文件

接着，我们使用 cmake 的新特性 Preset，这也是为什么我们需要 cmake 的版本大于 3.27 的原因：

Terminal window

1
cmake --preset=dev
2
cmake --build --preset=dev

此时，我们就在 build/dev 文件下生成了一个可执行文件 demo，使用命令:

Terminal window

1
./build/dev/demo

即可运行

使用第三方库

我们在 Conan 中可以搜索自己想要安装的包，例如 unordered_dense，然后，根据官网的说明，在 conanfile.py 与 CMakeLists.txt 中填入信息：

我们填入以下信息：

conanfile.py

1
from conan import ConanFile
2

3

4
class Recipe(ConanFile):
5
    settings = "os", "compiler", "build_type", "arch"
6
    generators = "CMakeToolchain", "CMakeDeps", "VirtualRunEnv"
7

8
    def layout(self):
9
        self.folders.generators = "conan"
10

11
    def requirements(self):
12
        self.requires("fmt/11.0.2")
13
        self.requires("unordered_dense/4.4.0")
14

15
    def build_requirements(self):
16
        self.test_requires("catch2/3.7.0")

CMakeLists.txt

1
find_package(fmt REQUIRED)
2
find_package(unordered_dense REQUIRED)
3
target_link_libraries(demo_lib PUBLIC fmt::fmt unordered_dense::unordered_dense)

Important

值得注意的是，在 CMakeLists.txt 中指定的库，我们需要将其设置为 PUBLIC，否则会导致链接失败