安装aicspylibczi库失败：Python读取CZI文件遇阻求助

我尝试用Python的aicsimageio库读取CZI格式文件，该库依赖aicspylibczi，但执行pip install aicspylibczi时出现如下错误：

pip install aicspylibczi

Collecting aicspylibczi
  Using cached aicspylibczi-3.1.2.tar.gz (7.7 MB)
  Installing build dependencies ... done
  Getting requirements to build wheel ... done
  Installing backend dependencies ... done
  Preparing metadata (pyproject.toml) ... done
Requirement already satisfied: numpy>=1.14.1 in c:\users\kvs62\pycharmprojects\epibolyseg\.venv\lib\site-packages (from aicspylibczi) (1.26.4)
Building wheels for collected packages: aicspylibczi
  Building wheel for aicspylibczi (pyproject.toml) ... error
  error: subprocess-exited-with-error

  × Building wheel for aicspylibczi (pyproject.toml) did not run successfully.
  │ exit code: 1
  ╰─> [41 lines of output]
      running bdist_wheel
      running build
      running build_py
      creating build
      creating build\lib.win-amd64-cpython-312
      creating build\lib.win-amd64-cpython-312\aicspylibczi
      copying aicspylibczi\CziFile.py -> build\lib.win-amd64-cpython-312\aicspylibczi
      copying aicspylibczi\types.py -> build\lib.win-amd64-cpython-312\aicspylibczi
      copying aicspylibczi\_version.py -> build\lib.win-amd64-cpython-312\aicspylibczi
      copying aicspylibczi\__init__.py -> build\lib.win-amd64-cpython-312\aicspylibczi
      running egg_info
      writing aicspylibczi.egg-info\PKG-INFO
      writing dependency_links to aicspylibczi.egg-info\dependency_links.txt
      writing requirements to aicspylibczi.egg-info\requires.txt
      writing top-level names to aicspylibczi.egg-info\top_level.txt
      reading manifest file 'aicspylibczi.egg-info\SOURCES.txt'
      reading manifest template 'MANIFEST.in'
      warning: no files found matching '*.h' under directory 'c_tests'
      warning: no files found matching '*.c' under directory 'c_tests'
      warning: no files found matching '*.py' under directory 'c_tests'
      warning: no files found matching '*.pyx' under directory 'c_tests'
      warning: no files found matching '*.pxd' under directory 'c_tests'
      warning: no files found matching '*.pxi' under directory 'c_tests'
      warning: no files found matching '*.pyd' under directory 'c_tests'
      warning: no files found matching '*.dll' under directory 'c_tests'
      warning: no files found matching '*.so' under directory 'c_tests'
      warning: no files found matching '*.d' under directory 'c_tests'
      warning: no files found matching '*.hpp' under directory '_aicspylibczi'
      warning: no files found matching '*.c' under directory '_aicspylibczi'
      warning: no files found matching '*.py' under directory '_aicspylibczi'
      warning: no files found matching '*.pyx' under directory '_aicspylibczi'
      warning: no files found matching '*.pxd' under directory '_aicspylibczi'
      warning: no files found matching '*.pxi' under directory '_aicspylibczi'
      warning: no files found matching '*.pyd' under directory '_aicspylibczi'
      warning: no files found matching '*.dll' under directory '_aicspylibczi'
      warning: no files found matching '*.so' under directory '_aicspylibczi'
      warning: no files found matching '*.d' under directory '_aicspylibczi'
      adding license file 'LICENSE'
      writing manifest file 'aicspylibczi.egg-info\SOURCES.txt'
      running build_ext
      error: [WinError 2] The system cannot find the file specified
      [end of output]

  note: This error originates from a subprocess, and is likely not a problem with pip.
  ERROR: Failed building wheel for aicspylibczi
Failed to build aicspylibczi
ERROR: Could not build wheels for aicspylibczi, which is required to install pyproject.toml-based projects

解决方案 #

1. 降级Python版本

你当前使用的是Python 3.12，aicspylibczi的预编译轮子可能还未适配这个版本。建议降级到Python 3.10或3.11，这两个版本有官方提供的预编译wheel，无需本地编译，直接执行pip install aicspylibczi即可完成安装。

2. 安装Visual Studio编译工具

如果坚持使用Python 3.12，需要配置Windows编译环境：

• 下载并安装Visual Studio Build Tools
• 安装时勾选「Desktop development with C++」组件，确保包含MSVC编译器、Windows SDK等核心工具
• 安装完成后重启终端，重新执行pip install aicspylibczi

3. 直接安装带CZI支持的aicsimageio

跳过单独安装aicspylibczi，直接安装包含CZI格式支持的aicsimageio扩展包：

pip install aicsimageio[czi]

这条命令会自动处理所有依赖，包括适配当前环境的aicspylibczi版本。

4. 手动下载预编译wheel文件

如果上述方法无效，可以手动下载对应平台的wheel文件：

• 确认你的Python版本（比如cp312）和系统架构（win_amd64）
• 找到对应版本的aicspylibczi wheel文件
• 通过本地文件安装：

pip install path/to/aicspylibczi-3.1.2-cp312-cp312-win_amd64.whl

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