本文详解 Conan 2.x 版本下 conanfile.py 的标准写法、常见导入错误根源及完整工作流，重点纠正 from conan import Conanfile（小写 f）这一高频误写，并说明系统安装版 Conan 已完全支持 conanfile.py，无需额外 pip 安装。
本文详解 conan 2.x 版本下 `conanfile.py` 的标准写法、常见导入错误根源及完整工作流，重点纠正 `from conan import conanfile`（小写 f）这一高频误写，并说明系统安装版 conan 已完全支持 `conanfile.py`，无需额外 pip 安装。
Conan 自 2.0 版本起全面重构 API，其核心约定之一是：ConanFile 类名严格遵循 PascalCase 大驼峰命名规范。你遇到的 ImportError: cannot import name 'Conanfile' from 'conan' 错误，根本原因正是 from conan import Conanfile 中的类名拼写错误——末字母 f 必须大写为 F，即 from conan import ConanFile。
✅ 正确写法（Conan 2.30.0 及后续版本强制要求）：
from conan import ConanFile # 注意：ConanFile，首字母 C 和 F 均大写
class ProjectRecipe(ConanFile):
settings = "os", "compiler", "build_type", "arch"
generators = "CMakeToolchain", "CMakeDeps"
def requirements(self):
self.requires("armadillo/12.6.4")
self.requires("boost/1.86.0")
self.requires("openssl/3.3.1")
self.requires("onnxruntime/1.18.1")⚠️ 关键说明：
- 系统安装版已完备支持 conanfile.py：Windows 上通过 .exe 安装器（如官方发布的 conan-2.30.0-windows-x86_64.exe）安装的 Conan，其 Python 运行时环境与标准库均已内置，完全兼容 conanfile.py 配方。无需、也不建议再执行 pip install conan —— 否则可能引发版本冲突或路径污染。
-
conan new 是最佳起点：为避免手写错误，推荐使用官方模板生成骨架项目：
conan new cmake_exe -d name=myapp -d version=1.0
该命令将自动生成符合当前 Conan 2.x 规范的 conanfile.py、CMakeLists.txt 和示例源码，开箱即用。
- 依赖声明需显式约束：self.requires("openssl/3.3.1") 等写法虽可运行，但强烈建议补充用户/通道（user/channel）以确保来源明确与二进制兼容性，例如 "openssl/3.3.1@conancenter"。若省略，Conan 默认查询 conancenter 远程，而部分旧版或特殊构建变体可能缺失预编译包，导致 --build=missing 未启用时失败。
- 执行位置必须精准：conan install . 命令必须在包含 conanfile.py 的目录下执行（而非项目根目录或 build/ 目录）。该目录即“依赖声明上下文”，Conan 将据此解析配方并生成 conan.lock、conan_toolchain.cmake 等构建所需文件。
? 总结操作流程：
- 确认 Conan 版本：conan --version（应 ≥ 2.0）；
- 修正 conanfile.py 导入语句为 from conan import ConanFile；
- 在 conanfile.py 所在目录执行：
conan install . --build=missing -s compiler.version=194 -s compiler.runtime=dynamic
- 在 CMake 构建目录中，通过 -DCMAKE_TOOLCHAIN_FILE=conan_toolchain.cmake 引入 Conan 生成的工具链。
遵循以上规范，即可充分发挥 Conan 2.x 的声明式依赖管理能力，实现跨平台、可复现、可审计的 C++ 项目构建。
