Auto PY to EXE开发环境搭建：从源码运行和贡献代码指南

想要深入了解Auto PY to EXE这款强大的Python打包工具吗？本指南将带你从零开始搭建完整的开发环境，让你不仅能够运行源码版本，还能为这个开源项目贡献代码！🚀

Auto PY to EXE是一个基于图形界面的Python脚本转换工具，它能够将.py文件轻松转换为.exe可执行文件。通过本指南，你将学会如何配置开发环境、运行源码版本以及参与项目贡献。

环境准备和依赖安装

Python版本要求

Auto PY to EXE支持Python 3.6-3.12版本。建议使用Python 3.8或更高版本以获得最佳兼容性。

克隆项目仓库

首先需要获取项目源码：

git clone https://gitcode.com/gh_mirrors/au/auto-py-to-exe
cd auto-py-to-exe

安装项目依赖

项目依赖在requirements.txt中明确列出，主要包括：

• Eel (>=0.11.0) - 用于构建Web界面
• PyInstaller (>=5.8.0) - 核心打包引擎
• requests - 网络请求库

使用以下命令安装依赖：

pip install -r requirements.txt

源码运行方法

直接运行源码版本

安装依赖后，可以通过以下命令运行Auto PY to EXE：

python -m auto_py_to_exe

开发模式安装

如果你想在开发过程中随时修改代码并立即看到效果，可以安装为开发模式：

pip install -e .

项目结构解析

了解项目结构是有效贡献代码的关键：

核心模块目录：auto_py_to_exe/

• main.py - 程序入口点
• ui.py - 用户界面逻辑
• packaging.py - 打包功能实现
• config.py - 配置管理

Web界面资源：auto_py_to_exe/web/

• js/ - JavaScript功能模块
• css/ - 样式文件
• img/ - 图标资源

开发工具配置

代码格式化工具

项目使用Ruff进行Python代码格式化，配置在pyproject.toml中：

[tool.ruff]
line-length = 120
indent-width = 4

运行测试

项目包含完整的测试套件，位于tests/目录。运行测试：

pip install pytest
pytest

贡献代码指南

报告问题

如果你发现了bug，请按照CONTRIBUTING.md中的指南创建详细的问题报告。

提交功能请求

如果你有新功能的创意，可以通过功能请求模板提交建议。

翻译贡献

项目支持多语言界面，你可以通过更新i18n.js文件来添加或更新翻译。目前支持超过20种语言！

实用开发技巧

使用配置参数

开发时可以充分利用命令行参数进行测试：

python -m auto_py_to_exe --help
python -m auto_py_to_exe --no-ui
python -m auto_py_to_exe --config examples/1-basic/auto-py-to-exe-config.json

调试技巧

• 使用--logging-level DEBUG获取详细日志
• 通过--build-directory-override指定构建目录
• 使用--language参数测试不同语言界面

常见开发问题解决

依赖冲突

如果遇到依赖版本冲突，可以尝试：

pip install --upgrade pip
pip install --force-reinstall -r requirements.txt

界面调试

开发Web界面时，可以修改auto_py_to_exe/web/目录下的文件，修改后会立即生效。

通过本指南，你现在应该已经具备了完整的Auto PY to EXE开发环境搭建能力。无论是运行源码版本还是为项目贡献代码，你都有了坚实的基础。开始你的开源贡献之旅吧！🎯