🚀 GeekServerTogo 使用手册

💡 一、功能介绍

• 📦 生成 EXE 可执行文件 基于 PyInstaller 与 Nuitka 进行深度优化，增强对多版本 Python 的兼容性，有效解决常见的模块遗漏问题。 支持以下自定义选项：
  • 设置程序图标
  • 控制是否显示控制台窗口

⚠️ 二、注意事项

✅ 必须包含的结构：

确保主程序入口定义如下结构，否则打包后无法正常运行：

 if __name__ == '__main__':
     main()  # 由此启动程序

🚫 禁止包含的结构：

以下语法虽然合法，但对旧版 Python打包兼容性差，请避免使用：

 def get_coordinates() -> Tuple[float, float]:
     # 函数返回值注解，兼容性不好，打包容易出错
     frame:()  # 易出错方式
     exit(0) # 要使用sys.exit()否则容易无法识别

建议使用以下等效写法：

 def get_coordinates():
     # 不使用类型注解，更通用
     return (x, y)

🛠️ 三、使用方法

✅ 环境说明：

🐍 建议使用 Python 3.10.11

🔧 所需依赖：

• 📦 安装 Python 第三方库： pip install -r dep/requirements.txt
• 🛠️ 安装 C++ 编译环境： vs_BuildTools.exe

📘 C++ 环境安装说明：

安装时请选择 使用C++的桌面开发 工作负载，并确保勾选 MSVC v142 或以上 与 Windows SDK。

上面方法用Nuitka打包时经常遇到检测不到，所以默认使用MinGW点击链接下载或者使用提供的包

• winlibs-x86_64-posix-seh-gcc-14.2.0-llvm-19.1.1-mingw-w64msvcrt-12.0.0-r2.zip
• 把上面解压目录下的bin目录添加到系统Path环境变量
• 

✅参数说明：

参数	说明
-f	指定要处理的 Python 脚本路径
-o	指定输出目录（默认为 result/）
-i	指定图标文件（.ico 格式）
-c	指定打包类型： • console：带控制台窗口（适合调试） • windowed：不显示控制台窗口（适合 GUI 程序）
-s	补充指定缺失模块， 如：-s cryptography -s PyQt5 ，用于强制包含某些打包检测不到的模块

✅ 示例命令：

 GeekServer.exe -f src/GeekPlante.py -i logo.ico -c windowed

如无特殊需求，仅需指定待处理文件即可：

 GeekServer.exe -f src/GeekPlante.py

📜 四、声明

本软件由 极客星球（GeekServer） 团队开发，面向广大用户免费开放使用。

您可以自由安装、使用本软件，无需支付任何费用。

⚠️ 使用须知：

• ✅ 本软件仅供学习、体验与非商业用途。
• ❌ 禁止以任何形式反编译、破解、篡改或绕过软件的安全机制。
• ❌ 禁止用于破坏性用途，包括但不限于：
  • 绕过授权机制
  • 植入恶意代码
  • 二次打包传播等行为

本软件由开发团队按 “原样” 提供，使用过程中产生的风险由用户自行承担。 开发者对因使用或误用本软件造成的任何直接或间接损失 不承担法律责任。

📬 如有建议或发现漏洞，欢迎通过公众号 GeekServer / GeekPlante 与我们联系，共建开源生态。

© 极客星球 GeekServer 2025 保留所有权利

---

☕ 赞助支持

如果您觉得本工具对您有帮助，欢迎通过以下方式支持我们持续开发与维护：

🧡 你的每一份鼓励，都是我们前进的动力！

您可以通过公众号 GeekServer / GeekPlante 与我们取得联系，获取赞助方式或提交反馈建议。