Conan项目中使用python_requires时避免调用ConanAPI的注意事项

在Conan包管理工具的实际使用中，开发者经常会遇到需要在多个配方(recipe)之间共享公共代码的情况。Conan提供了python_requires机制来实现这一需求，但使用时需要注意一个重要限制：不能在python_requires中调用ConanAPI。

问题现象

当开发者在python_requires的代码中直接或间接地调用了ConanAPI时，会导致Conan命令（如inspect或create）在执行过程中挂起。通过调试工具可以发现，进程会在尝试获取某个锁时陷入死锁状态。

根本原因

Conan的设计架构决定了它不是一个可重入的系统。这意味着：

1. 不能在已经运行的Conan进程中再次调用Conan
2. 这包括从配方代码、钩子(hook)、插件或任何由Conan执行的代码中调用Conan
3. 间接调用同样被禁止，例如在构建脚本中调用Conan

这种限制的存在是因为Conan内部使用了各种锁机制来保证线程安全，当尝试在已经持有锁的情况下再次获取锁时，就会导致死锁。

解决方案

如果您的python_requires代码中确实需要访问Conan的功能，可以考虑以下替代方案：

1. 将需要ConanAPI的功能移到自定义命令(custom command)中
2. 使用独立的Python脚本来完成这些操作，而不是在配方加载时执行
3. 重构代码，避免在python_requires初始化时就调用ConanAPI

最佳实践

在使用python_requires时，建议遵循以下原则：

1. 保持python_requires中的代码尽可能简单
2. 避免在模块加载时执行复杂操作
3. 将需要Conan交互的功能延迟到配方方法中执行
4. 仔细检查所有导入的第三方库，确保它们不会间接调用ConanAPI

通过遵循这些原则，可以避免因不当使用ConanAPI而导致的死锁问题，确保构建过程的稳定性和可靠性。

记住，ConanAPI仅设计用于在自定义命令或用户Python脚本中使用，绝不能在配方、钩子或插件代码中调用。理解并遵守这一限制对于构建稳健的Conan工作流至关重要。