MetaCore-startup/tools/README_打包.md

MetaCore 打包说明

📦 已创建的打包文件

我已经为您创建了多个打包工具，您可以根据环境选择使用：

1. 批处理文件（Windows 推荐）

• quick_build.bat - 快速打包脚本（推荐）
• build.bat - 基础打包脚本

2. PowerShell 脚本

• build.ps1 - PowerShell 打包脚本

3. Python 脚本

• build_simple.py - 简化 Python 打包脚本
• build_config.py - 完整配置打包脚本

4. 说明文档

• 打包指南.md - 详细打包指南
• README_打包.md - 本文件

🚀 快速开始

方法一：使用批处理文件（最简单）

1. 右键点击 quick_build.bat
2. 选择 "以管理员身份运行"
3. 等待 打包完成
4. 查看 dist 文件夹中的 MetaCore.exe

方法二：使用命令提示符

1. 打开命令提示符（按 Win+R，输入 cmd）
2. 切换到项目目录：

   cd C:\Users\29381\Desktop\MetaCore
   

3. 运行打包脚本：

   quick_build.bat
   

方法三：手动打包

如果自动脚本不工作，可以手动执行：

1. 安装 PyInstaller：

   pip install pyinstaller
   

2. 安装项目依赖：

   pip install PyQt5
   

3. 执行打包命令：

   pyinstaller --onefile --windowed --name=MetaCore --add-data="MetaCore/data;data" --add-data="MetaCore/ui;ui" --hidden-import=PyQt5.sip MetaCore/main.py
   

📁 输出文件

打包成功后，您会得到：

• dist/MetaCore.exe - 可执行文件（这是您需要的主文件）
• build/ - 临时构建文件（可以删除）
• MetaCore.spec - PyInstaller 配置文件

🎯 使用打包后的程序

1. 复制 dist/MetaCore.exe 到任意位置
2. 双击 MetaCore.exe 即可运行
3. 无需 安装 Python 或其他依赖
4. 可以 分发给其他用户使用

⚠️ 常见问题

Python 未找到

• 确保已安装 Python 3.7+
• 确保 Python 已添加到系统 PATH
• 尝试使用 py 命令替代 python

PyInstaller 安装失败

python -m pip install --upgrade pip
python -m pip install pyinstaller

打包失败

1. 检查所有文件是否完整
2. 确保没有其他程序占用文件
3. 以管理员身份运行打包脚本

生成的文件过大

• 正常情况下文件大小约 50-100MB
• 这是因为包含了完整的 Python 运行时和 PyQt5 库

🔧 高级配置

如需自定义打包配置，可以：

1. 编辑 MetaCore.spec 文件
2. 运行：

   pyinstaller MetaCore.spec
   

📞 技术支持

如果遇到问题：

1. 查看 打包指南.md 获取详细说明
2. 检查命令行输出的错误信息
3. 确保所有依赖都已正确安装

🎉 完成

打包成功后，您就可以：

• ✅ 在任何 Windows 电脑上运行 MetaCore
• ✅ 分发给其他用户使用
• ✅ 无需安装任何依赖

祝您使用愉快！