From 421fea062b065bb0571c288ed290c412ace7f552 Mon Sep 17 00:00:00 2001 From: xiaji Date: Tue, 3 Feb 2026 17:19:24 +0800 Subject: [PATCH] =?UTF-8?q?docs(README):=20=E6=9B=B4=E6=96=B0PyInstaller?= =?UTF-8?q?=E6=89=93=E5=8C=85=E8=AF=B4=E6=98=8E=E5=B9=B6=E6=B7=BB=E5=8A=A0?= =?UTF-8?q?=E5=8F=82=E6=95=B0=E8=A7=A3=E9=87=8A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 添加详细的打包命令和参数说明,包括清理脚本和打包日志信息 --- README.md | 29 ++++++++++++++++++++++++----- 1 file changed, 24 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 3c7a7e2..6d2548c 100644 --- a/README.md +++ b/README.md @@ -230,18 +230,37 @@ python main.py ## 打包发布 -项目提供PyInstaller打包配置(build.spec),可将应用打包为独立可执行文件: +项目使用PyInstaller将应用打包为独立可执行文件: +### 打包命令 ```bash # 安装PyInstaller pip install pyinstaller -# 打包应用 -pyinstaller build.spec - -# 执行文件将在dist目录下生成 +# 打包应用(生成单个exe文件) +pyinstaller --onefile --noconsole --icon=guba.ico --distpath=. --hidden-import=PySide6.Qt6Compat --exclude-module PyQt5 --exclude-module PyQt6 main.py ``` +### 打包参数说明 +- `--onefile`: 打包成单个exe文件 +- `--noconsole`: 不显示控制台窗口 +- `--icon=guba.ico`: 使用guba.ico作为程序图标 +- `--distpath=.`: 在当前目录生成exe文件 +- `--hidden-import=PySide6.Qt6Compat`: 显式导入PySide6兼容模块 +- `--exclude-module PyQt5 --exclude-module PyQt6`: 排除其他Qt绑定,避免冲突 + +### 清理打包残留 +打包完成后,可运行清理脚本删除build和dist文件夹: +```bash +python .trae/skills/pyinstaller-one/clean.py +``` + +### 打包日志 +打包命令已保存在 `package.log` 文件中,方便后续查阅和重复使用。 + +### 执行文件 +打包完成后,`main.exe` 文件将在当前目录生成,可直接运行,无需安装Python环境。 + ## 注意事项 1. **API费用**: 使用大语言模型API可能产生费用,请注意控制调用频率