ModuleNotFoundError: No module named ‘cairosvg‘

遇到 ModuleNotFoundError: No module named 'cairosvg' 错误，说明你的 Python 环境中未安装 cairosvg 库。以下是分步解决方案：

---

1. 安装系统级依赖

cairosvg 依赖 Cairo 图形库，需先安装系统级依赖：

Ubuntu/Debian:

sudo apt-get install -y libcairo2-dev pkg-config

macOS (Homebrew):

brew install cairo pkg-config

Windows:

• 下载 Cairo Windows 预编译包
• 将 cairo.dll 添加到系统路径或项目目录中。

---

2. 安装 Python 包

使用 pip 安装 cairosvg：

pip install cairosvg

如果使用虚拟环境：

# 激活虚拟环境后安装
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate     # Windows
pip install cairosvg

---

3. 验证安装

运行以下代码测试是否成功：

import cairosvg
cairosvg.svg2png(bytestring=b'<svg><rect width="100" height="100"/></svg>', write_to='output.png')

---

常见问题

• 权限问题：在 Linux/macOS 上尝试 sudo pip install cairosvg（不推荐，优先使用虚拟环境）。
• 多版本 Python：确保 pip 对应当前 Python 版本（如 pip3 对应 Python 3）。
• 依赖缺失：若安装失败，检查系统依赖是否安装完整。

如果仍有问题，请提供操作系统和 Python 版本信息进一步排查。