### 安装 Cairo 和 Pycairo 的解决方案 当遇到 `ModuleNotFoundError: No module named 'cairo'` 错误时，通常是因为缺少必要的依赖项或未正确安装相关模块。以下是针对该问题的具体解决方法： #### 1. **确认系统环境** 在安装任何软件包之前，需确保操作系统已安装所需的开发工具和库。对于 Linux 或 macOS 用户，可以通过以下命令安装基础的 Cairo 库及其头文件： ```bash sudo apt-get install libcairo2-dev pkg-config python3-dev build-essential # 对于 Ubuntu/Debian brew install cairo # 对于 macOS 使用 Homebrew ``` Windows 用户则需要额外配置 MSYS2 或其他类似的构建环境来获取 Cairo 开发库。 #### 2. **通过 Pip 安装 Pycairo** 如果系统的 Cairo 库已经正确安装，则可以直接使用 pip 来安装 Pycairo 模块： ```bash pip install pycairo ``` 此操作适用于大多数标准环境下的 Python 版本[^2]。然而，在某些情况下（尤其是 Windows），可能由于缺乏编译器或其他依赖而失败。 #### 3. **处理 Windows 上的特殊需求** 在 Windows 平台上，推荐的方法是从预编译二进制文件中获取适合当前 Python 解释器版本的 `.whl` 文件并手动安装。可以访问 [Unofficial Windows Binaries for Python Extension Packages](https://www.lfd.uci.edu/~gohlke/pythonlibs/#pycairo) 下载对应的轮子文件，并执行如下命令完成安装： ```bash pip install path_to_downloaded_file.whl ``` 这种方法能够有效规避因本地缺失必要组件而导致的编译错误[^4]。 #### 4. **考虑 cairocffi 替代方案** 作为另一种选择，cairocffi 提供了一个兼容性强且易于使用的接口设计，其底层实现基于 cffi 技术而非传统的 C 扩展方式。因此即使主机上不存在完整的 Cairo 构建链路也依然可行。要设置 cairocffi 可简单运行下面这条指令即可： ```bash pip install cairocffi ``` 值得注意的是，虽然两者功能相似但并非完全一致；例如 pixbuf 支持仅存在于 cairocffi 中[^5]。 #### 示例代码片段展示如何加载基本图形绘制服务 ```python import cairocffi as cairo surface = cairo.ImageSurface(cairo.FORMAT_ARGB32, 100, 100) context = cairo.Context(surface) # 设置颜色填充背景为白色 context.set_source_rgb(1, 1, 1) context.rectangle(0, 0, 100, 100) context.fill() # 绘制一条蓝色线条 context.move_to(10, 10) context.line_to(90, 90) context.set_line_width(2) context.set_source_rgba(0, 0, 1, 1) context.stroke() ```