Conan是成熟灵活的跨平台C++依赖管理工具，核心在于包定义、远程仓库、本地缓存和配置四环节；支持conanfile.txt/.py声明依赖，集成CMake生成标准文件，并可创建上传自定义包。
Conan 是 C++ 项目中成熟、灵活且跨平台的依赖管理工具，它不依赖构建系统（CMake/Make/Ninja 等均可），能统一管理头文件、静态库、动态库、构建脚本等二进制产物。用好 Conan 的关键在于理解 包定义（conanfile.py 或 conanfile.txt）、远程仓库（remote）、本地缓存（cache）和配置（profile） 四个核心环节。
1. 初始化项目并声明依赖（conanfile）
在项目根目录创建 conanfile.txt（适合简单项目）或 conanfile.py（推荐用于需要自定义逻辑的项目）。
- conanfile.txt 示例：简洁声明依赖和构建设置
[requires] fmt/10.2.1 openssl/3.2.1[generators] CMakeDeps CMakeToolchain
[layout] cmake_layout
- conanfile.py 示例：支持版本逻辑、条件依赖、自定义构建步骤
from conan import ConanFile from conan.tools.cmake import cmake_layoutclass MyProject(ConanFile): settings = "os", "compiler", "build_type", "arch" generators = "CMakeDeps", "CMakeToolchain"
def requirements(self): self.requires("fmt/10.2.1") if self.settings.os == "Linux": self.requires("openssl/3.2.1")
2. 配置远程仓库与下载依赖
Conan 默认只启用 conancenter（官方中心仓库），但很多企业或私有包需添加自定义 remote。
- 查看已配置远程：
conan remote list - 添加私有仓库：
conan remote add my-company https://my-conan.company.com/v1 - 安装依赖（解析 + 下载 + 生成构建所需文件）：
conan install . --build=missing -
--build=missing表示本地没有对应二进制时自动从源码构建；生产环境建议用--build=never强制使用预编译包
3. 在 CMake 中集成 Conan 生成的文件
Conan 通过 CMakeDeps 和 CMakeToolchain 生成标准 CMake 文件，让 CMake 原生识别 Conan 包。
-
CMakeDeps生成*-config.cmake文件（如fmt-config.cmake），供find_package()使用 -
CMakeToolchain生成conan_toolchain.cmake，统一传递编译器、架构、标准等设置 - CMakeLists.txt 中只需两行即可接入：
cmake_minimum_required(VERSION 3.23) project(MyApp)加载 Conan 提供的 toolchain（必须放在 project() 之后、其他命令之前）
set(CMAKE_TOOLCHAIN_FILE $ENV{CONAN_TOOLCHAIN_FILE} CACHE STRING "") if(EXISTS ${CMAKE_TOOLCHAIN_FILE}) include(${CMAKE_TOOLCHAIN_FILE}) endif()
查找并链接 Conan 包
find_package(fmt REQUIRED) add_executable(app main.cpp) target_link_libraries(app fmt::fmt)
4. 创建并上传自己的包（conan create / conan upload）
将你自己的库发布为 Conan 包，便于团队复用或 CI 统一管理。
- 编写
conanfile.py描述包元信息、源码位置、构建逻辑和包结构 - 本地测试打包：
conan create . --name=mylib --version=1.0.0 - 上传到远程：
conan upload "mylib/1.0.0" -r=my-company --all - 注意：上传前确保 remote 已登录（
conan user -r my）且包名/版本符合语义化规则
-company -p xxx
-company -p xxxConan 不是“黑盒”，它的设计围绕可重现性与可审计性展开。只要理清包声明、远程协作、CMake 集成和本地开发流程这四个支点，就能稳定支撑中小型到大型 C++ 工程的依赖治理。不需要一开始就写复杂 conanfile.py，从 conanfile.txt 起步，再逐步引入 profile、lockfile 和私有 remote，节奏更可控。
