WeasyPrint在Windows系统下libfontconfig-1.dll加载问题解决方案

问题现象

在Windows系统上使用WeasyPrint时，部分用户会遇到OSError: ctypes.util.find_library() did not manage to locate a library called 'libfontconfig-1'错误。这个错误通常发生在尝试渲染PDF时，表明系统无法找到关键的字体配置库。

问题根源

这个问题主要与Windows系统下的动态链接库(DLL)加载机制有关。WeasyPrint依赖于Pango进行文本布局和字体处理，而Pango又需要fontconfig库。在Windows环境下，这些依赖关系需要通过特定的方式配置才能正常工作。

解决方案

方案一：使用conda环境

1. 创建新的conda环境：conda create -n weasyprint python=3.12
2. 激活环境：conda activate weasyprint
3. 安装WeasyPrint和依赖：conda install -c conda-forge weasyprint
4. 安装Pango：conda install -c anaconda pango

这种方法通过conda的依赖管理系统自动处理所有必要的库依赖关系，是最简单可靠的解决方案。

方案二：手动配置DLL路径

如果坚持使用系统Python或MSYS2安装的Pango，可以尝试以下步骤：

1. 确保Python是64位版本
2. 确认libfontconfig-1.dll确实存在于MSYS2的bin目录中
3. 在代码中显式添加DLL搜索路径：

import os
os.add_dll_directory('E:\\MSYS2\\mingw64\\bin')

4. 测试是否能成功加载库：

import cffi
ffi = cffi.FFI()
ffi.dlopen('libfontconfig-1.dll')

注意事项

1. 避免使用Microsoft Store安装的Python，这可能导致权限问题
2. 确保所有组件(WeasyPrint、Pango、fontconfig)都是相同架构(32位或64位)
3. 环境变量WEASYPRINT_DLL_DIRECTORIES必须正确设置包含所有必要DLL的路径

总结

Windows环境下WeasyPrint的字体配置问题主要源于动态库加载机制。对于大多数用户，推荐使用conda环境管理依赖，这是最简便的解决方案。对于需要自定义配置的高级用户，可以手动管理DLL路径，但需要注意架构一致性和路径设置的正确性。

通过以上方法，应该能够解决Windows系统下WeasyPrint的libfontconfig-1.dll加载问题，确保PDF生成功能正常工作。