手搓PyStand专属压缩工具,让你的Python程序瘦成一道闪电

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的清爽世界。