TradingAgents-CN 在 Windows 导出 PDF 时 WeasyPrint 因 Cairo 库缺失不可用怎么解决【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN在 Windows 环境运行 TradingAgents-CN 并导出分析报告为 PDF 时如果后端反复提示找不到 Cairo 库WeasyPrint 会被判定为不可用。原因是 WeasyPrint 依赖 Cairo 图形库来渲染 PDF而在 Windows 上 Cairo 不会随 pip 包自动安装必须手动安装 GTK3 运行时。仓库的 Windows Cairo 库缺失修复指南 给出的主路径是安装 GTK3 运行时安装时勾选 Add to PATH→ 重启终端和后端 → 通过启动日志确认 WeasyPrint 可用 → 在前端实际导出一份 PDF 验证。如果环境装不了 GTK3文档同时给出了 pdfkit wkhtmltopdf 的替代路径。问题现象与原因Windows 缺少 Cairo 库时典型的错误信息文档原文是no library called cairo-2 was found no library called cairo was found no library called libcairo-2 was found cannot load library libcairo.so.2: error 0x7e cannot load library libcairo.2.dylib: error 0x7e cannot load library libcairo-2.dll: error 0x7e相关现象还包括 WeasyPrint 加载时抛出OSError: cannot load library gobject-2.0-0——PDF 导出工具安装指南 将这类错误同样归因于缺少 GTK3 运行时。方案一安装 GTK3 运行时推荐文档将其列为最彻底的解决方案安装后 WeasyPrint 即可正常工作。1. 下载并安装 GTK3 运行时到 tschoonj/GTK-for-Windows-Runtime-Environment-Installer 项目的 releases 页面下载最新版本选择文件名为gtk3-runtime-x.x.x-x-x-x-ts-win64.exe的安装包文档示例使用的版本是gtk3-runtime-3.24.31-2022-01-04-ts-win64.exe。双击.exe文件按向导安装务必勾选 Add to PATH添加到系统路径——这个选项决定后端进程能否找到 Cairo 库漏选会导致安装后仍然报错。2. 确认 WeasyPrint 已安装PDF 导出工具安装指南 中 Windows 一节的顺序是先装 GTK3 运行时必需再装 WeasyPrintpip install weasyprint也可以直接用项目 extras 安装 PDF 支持包含 weasyprint 和 pdfkitpip install -e .[pdf]3. 重启终端与后端服务关闭所有终端窗口重新打开新终端让新的 PATH 生效然后重启后端python -m uvicorn app.main:app --reload4. 验证修复结果文档给出的验证方式有两步查看后端启动日志应该看到文档原文的预期日志✅ WeasyPrint 可用推荐的 PDF 生成工具打开前端界面生成一份分析报告点击导出 → PDF能成功下载 PDF 文件即说明修复完成。文档还给了一个 Python 检查片段from app.utils.report_exporter import ReportExporter exporter ReportExporter() print(fWeasyPrint 可用: {exporter.weasyprint_available}) print(fpdfkit 可用: {exporter.pdfkit_available}) print(fPandoc 可用: {exporter.pandoc_available})注意当前仓库的 app/utils/report_exporter.py 源码中ReportExporter实际只暴露export_available、pandoc_available、pdfkit_available属性并没有weasyprint_available。如果你的代码版本运行该片段时缺少对应属性以后端启动日志和实际 PDF 导出结果为准不必以该片段报错作为修复失败的判断。安装 GTK3 后仍报错时按文档给出的排查顺序逐项处理确认 GTK3 已添加到系统 PATH即安装时选了 Add to PATH重启所有终端窗口重启后端服务如果仍然不行重启电脑。无法安装 GTK3 时的替代方案如果环境不允许安装 GTK3文档给出的替代路径是 pdfkit wkhtmltopdfpip install pdfkit再从 wkhtmltopdf 官方下载页安装 Windows 版本wkhtmltox-x.x.x_msvc2015-win64.exe默认安装路径为C:\Program Files\wkhtmltopdf。安装后在终端验证它是否在 PATH 中wkhtmltopdf --version如果打印不出版本号说明 wkhtmltopdf 不在 PATH 中需手动将其加入系统环境变量。然后重启后端python -m uvicorn app.main:app --reload日志应出现✅ pdfkit wkhtmltopdf 可用此后系统会自动改用 pdfkit 生成 PDF。文档还提到最后的回退方案是 Pandoc并明确提示该方案可能仍存在中文竖排问题不推荐作为首选。三种工具都不可用时可以运行仓库自带的安装脚本 scripts/setup/install_pdf_tools.py 检查依赖并获取安装指引。先说明它的副作用脚本会依次执行pip install安装 markdown、weasyprint、pdfkit、pypandoc 等包并检查 wkhtmltopdf、pandoc 是否可用在 Windows 上它不会自动安装 GTK3 运行时只打印下载指引python scripts/setup/install_pdf_tools.py相关文档Windows Cairo 库缺失修复指南本文主路径的完整出处含三种方案的对比表PDF 导出工具安装指南各平台的安装方式与验证方法PDF 导出功能使用指南工具优先级、导出流程与常见问题Docker 环境 PDF 导出支持如果条件允许改用 Docker 部署镜像已内置 WeasyPrint 及其系统依赖含libcairo2等无需在 Windows 上手动安装 GTK3【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考