Mu编辑器开发环境搭建指南

前言

Mu是一款专为教育场景设计的Python代码编辑器，特别适合初学者使用。本文将详细介绍如何搭建Mu编辑器的开发环境，帮助开发者快速上手项目开发工作。

环境准备

基础要求

Mu编辑器仅支持Python 3.5及以上版本，明确不支持Python 2.x系列。在开始前，请确保你的系统已安装符合要求的Python版本。

获取源代码

首先需要获取Mu编辑器的源代码。建议使用版本控制工具克隆项目仓库到本地。

开发环境配置

虚拟环境创建

强烈建议使用虚拟环境进行开发，以避免依赖冲突问题。特别是在Windows系统上，建议使用标准库中的venv模块创建虚拟环境：

py -3 -mvenv .venv

依赖安装

激活虚拟环境后，执行以下命令安装所有开发依赖：

pip install -e ".[dev]"

这个命令会安装：

• 运行时的必需依赖
• 测试相关依赖
• 文档构建依赖
• 国际化翻译依赖
• 打包相关依赖

特殊说明

对于PyQt相关依赖，不同版本间可能存在冲突。如果遇到问题，建议删除现有虚拟环境并重新创建。

不同平台的特殊配置

macOS ARM架构设备

使用Apple Silicon芯片(M1/M2)的Mac设备需要特殊处理：

1. 切换到pyqt6分支
2. 修改setup.py文件，移除ARM架构相关限制条件
3. 重新安装依赖

修改后PyQt相关依赖应保留为：

"PyQt6==6.3.1",
"PyQt6-QScintilla==2.13.3",
"PyQt6-Charts==6.3.1",

Raspberry Pi配置

树莓派需要额外步骤：

1. 通过apt安装系统依赖：

sudo apt-get install python3-pyqt5 python3-pyqt5.qsci python3-pyqt5.qtserialport python3-pyqt5.qtsvg python3-dev python3-gpiozero python3-pgzero libxmlsec1-dev libxml2 libxml2-dev

2. 创建系统包可访问的虚拟环境：

virtualenv -p /usr/bin/python3 --system-site-packages ~/mu-venv

3. 激活环境后安装Python依赖

运行开发版本

在项目根目录下，可通过以下任一方式启动开发版Mu：

python run.py
# 或
python -m mu
# 或
mu-editor

开发辅助工具

项目提供了Makefile简化常见开发工作流：

make run      # 运行开发版本
make test     # 运行测试套件
make docs     # 生成项目文档
make check    # 运行所有代码检查和测试
make win32    # 生成32位Windows安装包
make macos    # 生成macOS应用

建议在提交代码前执行make check确保代码质量。

注意事项

1. Linux系统如需使用MicroPython REPL功能，可能需要将用户加入dialout组
2. 树莓派配置仅适用于Raspbian "Stretch"版本
3. Windows平台可使用make.cmd替代make命令

通过本文介绍的步骤，开发者可以快速搭建完整的Mu编辑器开发环境，为项目贡献代码做好准备。