如何解决导入ProjectMaker时出现的cairo-2库缺失OSError？

问题本质 #

你遇到的OSError是因为Custom_Widgets依赖的cairosvg需要Cairo图形库支持，但Windows系统默认没有安装该库，导致cairocffi找不到对应的libcairo-2.dll等动态链接文件。

具体修复方案 #

方案1：用pip安装预编译的pycairo（最省事） #

直接通过pip安装适配Windows的pycairo包，它会自动包含所需的Cairo动态库：

pip install pycairo

安装完成后重启Python终端，再尝试导入ProjectMaker。

方案2：安装GTK运行时 #

Cairo是GTK运行时的核心组件，安装GTK运行时可以一次性解决依赖：

• 下载对应你系统位数的GTK运行时安装包（64位系统选x64版本）
• 运行安装程序，默认路径安装即可，安装后系统会自动把库路径加入PATH
• 重启你的Python环境（终端/IDE），重新执行导入操作

方案3：手动添加Cairo库文件（进阶） #

如果前两种方法不行，可以手动处理：

• 下载适配Windows 64位的libcairo-2.dll文件
• 将文件放到Python安装目录的DLLs文件夹里，或者你的项目根目录
• 也可以把该文件所在路径添加到系统PATH环境变量，然后重启终端

验证修复 #

执行以下代码测试：

from Custom_Widgets import ProjectMaker

如果没有抛出OSError，说明问题解决。

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