Conan二进制包命名规则怎么设计-C++-PHP中文网

合法conan包引用格式为package_name/version@user/channel，其中package_name仅含小写字母、数字、下划线、短横线且不以数字或短横线开头，version推荐语义化版本（如1.2.11），user和channel须显式指定且区分大小写。

conan二进制包命名规则怎么设计

conan包名和版本号怎么组合才合法

Conan 的包引用（reference）必须满足 package_name/version@user/channel 格式，其中 package_name 和 version 是必填项，user 和 channel 可选但强烈建议显式指定。不合法的命名会导致 conan create 失败或远程上传被拒。

package_name 只能含小写字母、数字、下划线、短横线（a-z0-9_-），不能以数字或短横线开头；例如 zlib 合法，1zlib 或 -zlib 非法
version 推荐遵循语义化版本（MAJOR.MINOR.PATCH），如 1.2.11；Conan 本身不限制格式，但 conan-center 官方仓库强制要求语义化版本，且禁止使用构建元数据（如 1.2.11+build.1）
user 通常代表组织或团队名（如 myorg、bincrafters），避免用 user 这类占位符上线；本地开发可临时用 local，但 CI 中应替换为真实标识
channel 建议固定为 stable、testing、snapshot 等语义明确值，不要混用大小写（STABLE 和 stable 被视为不同 channel）

为什么 package_id 会因命名改动而变

Conan 的 package_id 不直接由包名/版本决定，而是由 settings（如 os、compiler）、options（如 shared=True）以及 requires 的依赖关系共同计算得出。但如果你在 conanfile.py 中硬编码了包名或版本（比如用于生成头文件宏），这些字符串一旦变化，就会触发源码重建，间接导致新 package_id —— 因为 conan create 默认把 exports_sources 内容纳入源码哈希。

Conan 2.31.2

Conan 2.31.2 官方历史源码包，适合复现依赖解析、CMake 配置、二进制包兼容性和跨平台构建环境。

下载

避免在 conanfile.py 中写死 self.name = "mylib-2.0" 这类带版本的名称；应只写 self.name = "mylib"，版本走 self.version = "2.0"
如果要用版本号生成 C++ 宏（如 MYLIB_VERSION），建议通过 generate() 阶段写入临时头文件，而非在 package() 中复制含版本字面量的源文件
修改 user/channel 不影响 package_id，但会影响远程定位——同一个 package_id 在不同 @user/channel 下是独立缓存条目

conan-center 对命名的硬性限制有哪些

向 conan-center 提交包时，命名不是“能跑就行”，而是有明确准入规则。违反任一条件都会被 CI 拒绝，常见失败点包括：

package_name 必须与上游项目官方名称一致（如 OpenSSL → openssl，不是 open_ssl 或 libopenssl）
version 必须精确匹配上游发布 tag（如 GitHub release 页面的 v1.1.1w → 1.1.1w，去掉 v 前缀；不能写成 1.1.1 或 1.1.1w-final）
user 必须为 conancenter（旧版允许 conan，已弃用）
channel 必须为 stable（testing 仅限内部预发布流程）
整个 reference 不能含大写字母（OpenSSL/1.1.1w@conancenter/stable ❌，正确是 openssl/1.1.1w@conancenter/stable）

私有仓库要不要照搬 conan-center 规则

可以不照搬，但建议收敛命名策略，否则团队协作成本会上升。私有场景下最常被忽略的是 user 和 channel 的语义一致性：

多个团队共用一个远程时，user 应按组织结构划分（如 infra、iot、mobile），而不是每人用自己名字
channel 应绑定 CI 流水线阶段：比如 Jenkins job 名为 deploy-to-staging，就统一用 staging；避免混用 dev/devel/development
若用 Git 分支驱动构建（如 main → stable，develop → testing），需在 CI 脚本中自动提取分支名并映射，不要人工输错
特别注意：Conan 2.x 不再支持 @user/channel 为空的 reference（即 pkg/1.0），必须显式写出，哪怕只是 pkg/1.0@_/_