conan项目必须锁定依赖精确版本号并使用conan.lock文件固化整个依赖图。需禁用语义化版本范围，显式声明settings，启用ssl验证并配置可信镜像，避免隐式配置污染，确保构建可复现。
conanfile 中必须锁定依赖的精确版本号
Conan 默认允许语义化版本范围（如 fmt/[>10.0.0]），但这种写法在 CI 构建或跨团队协作时极易导致「今天能编、明天报错」。真实项目中，只要没做兼容性验证，fmt/10.2.1 和 fmt/10.3.0 就可能因 ABI 变更或头文件宏定义差异引发链接失败或运行时崩溃。
实操建议：
一款AI工具，主要用于在主代理响应前，并行运行Kimi K2.5和GPT 5.3 Codex，注入双方观点以增强认知多样性，适合需要提升相关任务效率的用户。
- 所有
[requires]或self.requires()必须写死完整版本号，例如fmt/10.2.1，禁用~、^、>等通配符 - 若需临时测试新版，改用
conan install --require="fmt/10.3.0"命令行覆盖，不修改配置文件 - 私有仓库中上传包时，务必在
conan create命令中显式指定--version=1.2.3，避免依赖本地 git tag 或时间戳生成不可控版本
启用远程仓库 SSL 验证并配置可信镜像
当 conan search 或 conan install 从 https://center.conan.io 拉包失败，常见原因是证书校验失败（如 SSLError: certificate verify failed）。这会导致 Conan 自动 fallback 到不安全的 HTTP 源，或静默跳过校验——后者会让中间人篡改包内容而无法察觉。
实操建议：
- 首次使用前执行
conan config install https://github.com/conan-io/conanclientcert.git，确保cacert.pem被正确加载 - 国内用户应优先添加可信镜像，例如：
conan remote add conancenter-mirror https://mirrors.tuna.tsinghua.edu.cn/conan-center/ - 禁用不安全 remote：
conan remote disable conancenter，只保留已验证的镜像源 - 检查 remote 是否启用 SSL：
conan remote list输出中确认[Verify SSL: True]
构建时显式声明 settings，避免隐式继承污染
Conan 的 settings（如 compiler.version、build_type）决定二进制包是否可复用。若未在 conan install 命令中明确传入，Conan 会尝试从环境变量或默认配置推断——一旦开发机和 CI 机器的 CC 环境变量不同，就可能拉到错误 ABI 的预编译包，导致 undefined reference 或 GLIBCXX_3.4.29 not found。
实操建议：
- 每次
conan install必须带全关键 settings 参数，例如：conan install .. --build=missing -s compiler=gcc -s compiler.version=11 -s compiler.libcxx=libstdc++11 -s build_type=Release - 将常用 settings 抽成 profile 文件（如
gcc11-release），用--profile:build=gcc11-release --profile:host=gcc11-release显式调用 - 禁止依赖
conan config set general.default_profile=xxx这类全局设置，它会在多项目间互相污染
用 conan lock 文件固化整个依赖图
仅锁住直接依赖（如 fmt/10.2.1）远远不够。fmt 本身可能依赖 zlib/1.2.13，而 zlib 又依赖 openssl/3.2.1。Conan 2.x 默认每次 install 都重新解析依赖图，若上游包更新了其子依赖，你的构建就可能意外升级 openssl，触发 TLS 协议变更或证书链校验失败。
实操建议：
- 首次安装后立即生成 lock 文件：
conan install .. --lockfile-out=conan.lock --build=missing [其他参数] - 后续构建全部基于 lock 文件：
conan install .. --lockfile=conan.lock --build=missing - CI 流水线中把
conan.lock提交进 Git，并在构建脚本开头加校验：conan lock check conan.lock - 升级依赖时，用
conan lock update conan.lock --requires="fmt/10.3.0"，而非直接改conanfile.txt后重装
