Plotly.py 开发环境在MacOS上的配置优化指南

在MacOS系统上配置Plotly.py开发环境时，开发者可能会遇到一些常见问题。本文将详细介绍如何正确设置开发环境，并解决可能出现的依赖冲突和测试失败问题。

Python版本选择

在MacOS Sonoma 14.4.1系统上，特别是使用Apple M3芯片的设备，建议使用Python 3.11.8版本创建conda环境。这是因为Python 3.12可能会导致某些依赖包（如pyzmq）安装失败。

创建环境的正确命令：

conda create -n plotly-dev python=3.11.8

依赖管理问题

项目中的optional-requirements.txt文件目前固定了pytest的版本为3.5.1，这是一个非常陈旧的版本，会导致测试运行失败。建议手动升级到最新稳定版本：

pip install pytest==8.1.1

Orca相关组件安装

测试套件中的orca相关测试需要额外组件支持：

1. 首先需要安装orca本身，可以通过下载预编译包手动安装
2. 还需要安装poppler库来处理PDF相关功能：

conda install poppler

测试环境验证

完成上述配置后，可以运行以下命令验证环境是否配置正确：

pytest packages/python/plotly/plotly/tests

注意测试套件中test_optional和test_orca模块可能会有一些预期外的失败，这通常与图形渲染环境的具体配置有关，不一定表示环境设置有误。

最佳实践建议

1. 建议使用conda而非pip来管理核心依赖，能更好地处理二进制依赖
2. 定期检查并更新requirements.txt中的版本约束
3. 对于M1/M2/M3芯片的Mac，优先使用arm64架构的conda环境
4. 考虑使用虚拟环境隔离系统Python和开发环境

通过遵循这些指导原则，开发者可以在MacOS上建立一个稳定可靠的Plotly.py开发环境，为后续的代码贡献和功能开发打下坚实基础。