使用Conan的项目在GitHub Actions Windows编译报错：找不到conan_toolchain

问题重现 #

项目在macOS、Linux（Ubuntu）平台编译正常，但在GitHub Actions的Windows runner中编译时触发CMake错误，提示找不到conan_toolchain文件，尽管该文件实际存在。报错日志如下：

-- Building for: Visual Studio 17 2022
CMake Error at C:/Program Files/CMake/share/cmake-3.27/Modules/CMakeDetermineSystem.cmake:154 (message):
  Could not find toolchain file: conan_toolchain
Call Stack (most recent call first):
  CMakeLists.txt:3 (project)

可能的原因及解决方法 #

• 路径格式不兼容
  Windows使用反斜杠\作为路径分隔符，而Unix类系统用斜杠/。如果工作流中传递给CMake的CMAKE_TOOLCHAIN_FILE参数用了Unix风格路径或相对路径，可能导致CMake无法识别。
  解决：传递工具链文件时使用完整绝对路径，或在Windows环境下转换路径格式。比如通过conan install的输出获取正确路径，或用PowerShell命令处理路径。

• 工作目录不匹配
  Windows runner的默认工作目录可能和macOS/Linux不同，或执行CMake时切换了目录，导致相对路径指向的工具链文件不在当前查找范围内。
  解决：执行CMake前，用Get-Location（Windows）命令打印当前目录，确认和生成conan_toolchain文件的目录一致。

• 工具链文件名不完整
  Windows环境下Conan生成的工具链文件可能带有.cmake后缀（如conan_toolchain.cmake），若CMake命令中只指定conan_toolchain，会导致找不到文件。
  解决：检查工具链文件的实际名称，确保CMake命令中指定完整文件名（如conan_toolchain.cmake）。

• 文件权限限制
  Windows runner中生成的conan_toolchain文件可能被设为只读，导致CMake无法读取。
  解决：在工作流中添加步骤赋予可读权限，比如PowerShell命令：Get-Item conan_toolchain.cmake | Set-ItemProperty -Name IsReadOnly -Value $false。

• CMake版本兼容性问题
  报错中使用的CMake 3.27可能和Conan生成的工具链文件存在兼容性冲突。
  解决：通过actions/setup-cmake动作指定Conan推荐的CMake版本，尝试升级或降低版本测试。

内容的提问来源于stack exchange，提问作者Rodrigo