Python程序分发一直是个让人头疼的问题。PyInstaller动辄打包出50MB的“巨无霸”，Nuitka编译时间长得能泡杯咖啡，而 Embedded Python 虽然小巧却总感觉缺了点什么。直到遇见 PyStand——这个只有几百KB的启动器，配合精简版 Embedded Python，能将一个完整PyQt5应用压缩到14MB以内。但问题来了：开发时的 script 文件夹散落着十几二十个 .py 文件，直接复制过去既不优雅又容易被用户误改，有没有办法像Java的 .jar 一样，把所有脚本打成一个包？
当然有。Python从2.6版本开始就内置了 zipimport 机制，可以直接从 .zip 文件中导入模块，而 .egg 格式本质上就是一个遵循特定结构的ZIP压缩包。这意味着我们只需将 script 文件夹打包成 .zip 或 .egg，扔到 PyStand.exe 旁边，再在启动脚本里追加一行 sys.path.append('script.zip')，整个应用就能无缝运行。说干就干，我花了两个小时用PyQt5撸了一个图形化打包工具，顺便把PyStand的集成逻辑梳理得明明白白，这篇文章便是全部的思考与代码。
为什么PyStand需要压缩包？
先看PyStand的标准部署结构。下载一个Embedded Python解压到 runtime 目录，把 PyStand.exe 和 PyStand.int 放在外层，再创建一个 script 文件夹存放你的业务代码。结构长这样：
MyApp/├── PyStand.exe├── PyStand.int├── runtime/├── site-packages/└── script/ ├── main.py ├── utils.py └── ui/ └── mainwindow.py
启动时 PyStand.int 负责把 script 加到 sys.path，然后 import main 触发入口。这个方案已经足够轻量，但 script 文件夹赤裸裸地躺在那里，用户随手就能点开修改，版本升级时也容易漏掉文件。如果能像发布单个可执行文件一样，把 script 变成一个 script.zip，不仅整洁，还能防止无意的篡改。
Python的 zipimport 完美支持这一点。当你执行 sys.path.append('script.zip') 后，Python会将这个ZIP文件视作一个虚拟文件系统，所有 import 语句都能从中解析模块。而且标准库的 zipfile 模块操作ZIP文件就像呼吸一样自然，这为自制打包工具扫清了所有障碍。
从零设计一个脚本压缩器
需求很纯粹：选一个源文件夹，指定输出位置，起个文件名，选个后缀（.egg 或 .zip），点一下按钮，几秒钟后得到一个压缩包。界面用PyQt5搭建，逻辑部分开一个后台线程避免阻塞UI，压缩进度用进度条反馈。
这里有个细节值得展开。ZIP压缩支持多种算法，ZIP_DEFLATED 是通用性最好的选择，它使用DEFLATE算法，压缩率和速度的平衡点恰到好处。在代码中我们只需调用 zipfile.ZipFile(dst_file, 'w', zipfile.ZIP_DEFLATED)，然后把遍历到的每个文件添加进去，并指定它在包内的相对路径 arcname。整个过程可以看作一个映射函数：
其中 relpath 计算文件相对于源文件夹的路径，确保解包后目录结构原封不动。
后台线程每写完一个文件就发射一次进度信号，UI线程接收后更新进度条。这种信号槽机制是Qt的精髓，也是保证界面流畅的关键。当压缩完成后，弹出一个消息框告知结果，用户即可在输出目录找到成品。
下面是完整的工具代码。你可以直接复制保存为 packager.py，安装好PyQt5后运行：
# packager.pyimport sysimport osimport zipfilefrom PyQt5.QtWidgets import ( QApplication, QMainWindow, QWidget, QVBoxLayout, QHBoxLayout, QLabel, QLineEdit, QPushButton, QFileDialog, QMessageBox, QProgressBar, QComboBox)from PyQt5.QtCore import Qt, QThread, pyqtSignalclassZipWorker(QThread):"""后台压缩线程""" progress = pyqtSignal(int) # 进度百分比 finished = pyqtSignal(bool, str) # 成功/失败, 消息def__init__(self, src_folder, dst_file): super().__init__() self.src_folder = src_folder self.dst_file = dst_filedefrun(self):try: file_list = []for root, dirs, files in os.walk(self.src_folder):for file in files: full_path = os.path.join(root, file) arcname = os.path.relpath(full_path, self.src_folder) file_list.append((full_path, arcname)) total = len(file_list)if total == 0: self.finished.emit(False, "源文件夹为空！")returnwith zipfile.ZipFile(self.dst_file, 'w', zipfile.ZIP_DEFLATED) as zf:for idx, (full_path, arcname) in enumerate(file_list): zf.write(full_path, arcname) percent = int((idx + 1) / total * 100) self.progress.emit(percent) self.finished.emit(True, f"打包成功！\n输出文件：{self.dst_file}")except Exception as e: self.finished.emit(False, f"打包失败：{str(e)}")classMainWindow(QMainWindow):def__init__(self): super().__init__() self.setWindowTitle("PyStand 脚本打包工具") self.setFixedSize(550, 280) self.init_ui()definit_ui(self): central = QWidget() self.setCentralWidget(central) layout = QVBoxLayout(central)# 源文件夹 src_layout = QHBoxLayout() src_layout.addWidget(QLabel("源文件夹：")) self.src_edit = QLineEdit() self.src_edit.setPlaceholderText("选择包含 Python 脚本的文件夹...") src_layout.addWidget(self.src_edit) self.src_btn = QPushButton("浏览") self.src_btn.clicked.connect(self.select_src_folder) src_layout.addWidget(self.src_btn) layout.addLayout(src_layout)# 输出目录 dst_layout = QHBoxLayout() dst_layout.addWidget(QLabel("输出目录：")) self.dst_edit = QLineEdit() self.dst_edit.setPlaceholderText("选择压缩文件的保存位置...") dst_layout.addWidget(self.dst_edit) self.dst_btn = QPushButton("浏览") self.dst_btn.clicked.connect(self.select_dst_folder) dst_layout.addWidget(self.dst_btn) layout.addLayout(dst_layout)# 文件名和格式 name_layout = QHBoxLayout() name_layout.addWidget(QLabel("文件名：")) self.name_edit = QLineEdit("script") name_layout.addWidget(self.name_edit) name_layout.addWidget(QLabel("格式：")) self.format_combo = QComboBox() self.format_combo.addItems([".egg", ".zip"]) name_layout.addWidget(self.format_combo) layout.addLayout(name_layout)# 进度条 self.progress = QProgressBar() self.progress.setValue(0) layout.addWidget(self.progress)# 打包按钮 self.pack_btn = QPushButton("开始打包") self.pack_btn.clicked.connect(self.start_pack) layout.addWidget(self.pack_btn, alignment=Qt.AlignCenter)# 状态标签 self.status_label = QLabel("就绪") layout.addWidget(self.status_label)defselect_src_folder(self): folder = QFileDialog.getExistingDirectory(self, "选择脚本文件夹")if folder: self.src_edit.setText(folder)defselect_dst_folder(self): folder = QFileDialog.getExistingDirectory(self, "选择输出目录")if folder: self.dst_edit.setText(folder)defstart_pack(self): src = self.src_edit.text().strip() dst_dir = self.dst_edit.text().strip() base_name = self.name_edit.text().strip() ext = self.format_combo.currentText()ifnot src ornot os.path.isdir(src): QMessageBox.warning(self, "错误", "请选择有效的源文件夹！")returnifnot dst_dir ornot os.path.isdir(dst_dir): QMessageBox.warning(self, "错误", "请选择有效的输出目录！")returnifnot base_name: QMessageBox.warning(self, "错误", "请输入文件名！")return dst_file = os.path.join(dst_dir, base_name + ext)if os.path.exists(dst_file): reply = QMessageBox.question(self, "确认覆盖",f"文件 {dst_file} 已存在，是否覆盖？", QMessageBox.Yes | QMessageBox.No)if reply != QMessageBox.Yes:return self.set_ui_enabled(False) self.progress.setValue(0) self.status_label.setText("正在打包...") self.worker = ZipWorker(src, dst_file) self.worker.progress.connect(self.progress.setValue) self.worker.finished.connect(self.on_finished) self.worker.start()defset_ui_enabled(self, enabled): self.src_edit.setEnabled(enabled) self.src_btn.setEnabled(enabled) self.dst_edit.setEnabled(enabled) self.dst_btn.setEnabled(enabled) self.name_edit.setEnabled(enabled) self.format_combo.setEnabled(enabled) self.pack_btn.setEnabled(enabled)defon_finished(self, success, message): self.set_ui_enabled(True) self.status_label.setText("完成"if success else"失败")if success: QMessageBox.information(self, "成功", message) self.progress.setValue(100)else: QMessageBox.critical(self, "失败", message) self.progress.setValue(0)if __name__ == "__main__": app = QApplication(sys.argv) win = MainWindow() win.show() sys.exit(app.exec_())
与PyStand的无缝集成
工具生成的 .egg 或 .zip 文件如何使用？答案是几乎不需要额外配置。默认的 PyStand.int 启动脚本已经包含了加载 script.egg 的逻辑，只需稍作扩展即可同时支持 .zip 格式：
import sys, osos.chdir(os.path.dirname(__file__))sys.path.append(os.path.abspath('script')) # 优先从文件夹加载（便于调试）sys.path.append(os.path.abspath('script.egg')) # 支持.egg格式sys.path.append(os.path.abspath('script.zip')) # 支持.zip格式import mainmain.main()
如果你只打算发布压缩包而不保留源码文件夹，可以把 sys.path.append('script') 那行删掉，进一步精简。PyStand.int 本身的机制是：PyStand.exe 启动时会优先检查同目录下是否存在 _pystand_static.int 静态入口文件，若存在则忽略主程序名直接执行它，否则才寻找与可执行文件同名的 .int 文件。这为多版本发布提供了灵活的入口管理策略。
有了这个工具，发布流程简化为三步：用PyStand模板搭好骨架，将业务脚本用本工具打成 script.egg 或 script.zip，最后把所有文件一股脑压缩成发布包。一个带GUI的完整应用，压缩后大小通常不超过15MB，而且启动速度极快，内存占用极低，简直是内网分发和便携工具的终极方案。
还有哪些进阶玩法？
压缩包机制不仅适用于脚本，也可以存放数据文件。比如你的应用需要加载一些配置文件、模板或静态资源，完全可以把它们一并塞进ZIP中，然后通过 pkgutil.get_data() 或 importlib.resources 读取。当然，zipimport 只能导入Python模块，对普通文件的访问需要借助 zipfile 模块手动处理，但这点额外代码量完全可以接受。
另一个值得探索的方向是增量更新。既然应用的核心逻辑都集中在 script.zip 中，那么只需替换这个压缩包就能完成版本升级，而不必重新下载整个运行时。配合一个简单的启动器检查更新，就能实现类似 Electron 的热更新效果，却只有其十分之一的体积。
最后，如果你对打包后的体积还有执念，可以尝试在ZIP压缩时启用 ZIP_LZMA 算法（需要Python 3.3+），它能比DEFLATE再压缩掉20%～30%的体积，代价是解压时略微增加CPU开销。当然，对大多数场景而言，默认的DEFLATE已经绰绰有余。
这就是PyStand与自制打包工具的全部秘密。代码拿去用，文章欢迎转发，让更多人告别臃肿的Python分发，拥抱5MB的清爽世界。
