uv虚拟环境无法安装kaleido，求Apple M1 Pro平台解决办法

安全阿岳

2026-6-15

在uv虚拟环境中解决kaleido安装问题的可行方案

目前并非无法在uv中使用kaleido，针对Apple M1 Pro（MacOS 15.1.1）的arm64平台，可尝试以下几种解决办法：

指定平台标记安装并写入依赖
在安装kaleido时明确指定适配arm64的平台参数，执行命令：
```
uv install kaleido --platform macos_arm64
```
之后在pyproject.toml的依赖中添加平台标记，确保后续环境同步时能正确识别：
```
[project.dependencies]
kaleido = [
  { version = ">=0.2.1", markers = "sys_platform == 'darwin' and platform_machine == 'arm64'" }
]
```
本地安装兼容的wheel包
从PyPI下载适配macos arm64架构的kaleido wheel包（例如kaleido-0.2.1-py2.py3-none-macosx_11_0_arm64.whl），然后通过uv安装本地文件：
```
uv install ./kaleido-0.2.1-py2.py3-none-macosx_11_0_arm64.whl
```
若需写入pyproject.toml，可使用本地文件引用：
```
[project.dependencies]
kaleido = { file = "./kaleido-0.2.1-py2.py3-none-macosx_11_0_arm64.whl" }
```
临时使用uv的pip兼容模式
若以上方法都不适用，可通过uv调用pip来安装kaleido，命令为：
```
uv pip install kaleido
```
安装完成后，kaleido会被自动记录到pyproject.toml中，后续uv同步环境时可正常识别。