手把手教你用pyinstxtractor和uncompyle6找回丢失的Python源码（附Python 3.8及以下版本完整流程）
从PyInstaller打包文件中抢救Python源码的实战指南
那天下午，当系统崩溃后你发现Git仓库损坏、本地备份失效，唯一剩下的只有那个三个月前用PyInstaller打包的exe文件时，那种窒息感我深有体会。作为处理过数十起类似案例的技术顾问，我将带你体验一场真实的"源码救援行动"——不是照本宣科的工具说明书，而是包含血泪教训的实战手册。
1. 紧急评估：你的救援行动是否可行
在开始之前，我们需要确认几个关键因素：
- Python版本：uncompyle6目前稳定支持到Python 3.8，如果你的程序是用3.9+打包的，需要改用pycdc等工具
- 打包方式：确认是否使用标准PyInstaller打包（
pyinstaller --onefile或--onedir） - 文件完整性：检查exe文件是否能正常运行，损坏的文件会增加恢复难度
重要提示：反编译得到的代码不可能100%还原，特别是注释和变量命名可能发生变化，但业务逻辑通常可以完整恢复。
2. 搭建救援环境：工具链配置
工欲善其事，必先利其器。我们需要准备以下工具：
pyinstxtractor：
wget https://github.com/extremecoders-re/pyinstxtractor/archive/master.zip unzip master.zipuncompyle6：
pip install uncompyle6==3.8.0 # 指定稳定版本十六进制编辑器（可选）：
- Windows: HxD
- Mac: Hex Fiend
- Linux: bless
工具版本兼容性对照表：
| 工具名称 | 适用Python版本 | 关键限制 |
|---|---|---|
| pyinstxtractor | 所有版本 | 需与打包时Python版本匹配 |
| uncompyle6 | 2.4-3.8 | 3.9+需使用pycdc |
3. 核心救援流程：分步拆解
3.1 提取.pyc字节码文件
将你的exe文件（例如app.exe）和pyinstxtractor.py放在同一目录，执行：
python pyinstxtractor.py app.exe成功执行后会生成app.exe_extracted目录，里面包含几个关键文件：
PYZ-00.pyz_extracted：第三方依赖库app（或app.pyc）：主程序字节码struct：文件结构信息
常见问题处理：
- 如果看到
Error: Unsupported PyInstaller version，尝试更新pyinstxtractor - 出现
RuntimeError: Bad magic number说明Python版本不匹配
3.2 修复Magic Number
这是最易出错的环节。用十六进制编辑器打开.pyc文件，在文件开头插入8字节的Magic Number：
Python版本与对应Magic Number：
| Python版本 | Magic Number（十六进制） |
|---|---|
| 3.7 | 42 0D 0D 0A 00 00 00 00 |
| 3.8 | 55 0D 0D 0A 00 00 00 00 |
专业技巧：可以通过
import imp; print(imp.get_magic())获取当前Python解释器的Magic Number
3.3 反编译为可读源码
执行反编译命令：
uncompyle6 app.pyc > app_decompiled.py如果遇到Unknown magic number错误，检查：
- Magic Number是否正确
- Python版本是否匹配
- 文件是否损坏
4. 高级救援技巧
4.1 处理依赖库恢复
在PYZ-00.pyz_extracted目录中，你会找到所有导入的第三方库的.pyc文件。按相同流程处理：
- 为每个.pyc文件添加正确的Magic Number
- 批量反编译脚本示例：
import os from uncompyle6 import decompile_file for root, _, files in os.walk('PYZ-00.pyz_extracted'): for file in files: if file.endswith('.pyc'): output = f"{file[:-4]}_decompiled.py" with open(output, 'w') as f: decompile_file(os.path.join(root, file), f)
4.2 处理反编译失败的代码块
当遇到无法反编译的代码时，可以：
- 尝试使用
--verify选项检查字节码完整性uncompyle6 --verify app.pyc - 使用
dis模块分析字节码：import dis, marshal with open('app.pyc', 'rb') as f: code = marshal.load(f) dis.dis(code) - 手动重构关键业务逻辑
5. 预防胜于救援：建立代码安全网
经历过源码丢失的痛，你应该建立多重防护：
版本控制：
- 本地Git + 远程备份（GitHub/GitLab）
- 提交前自动打包验证
构建归档：
# 创建包含源码和环境的完整存档 tar czvf project_backup_$(date +%F).tar.gz \ --exclude='*.pyc' \ --exclude='__pycache__' \ project_dir/ requirements.txt注释嵌入：
__version__ = "1.0" __build__ = "2023-07-20" __source__ = "git:commit-hash"
在最近一次为客户恢复金融分析工具的过程中，我们发现虽然反编译成功了，但部分算法性能下降了30%。通过对比不同版本的.pyc文件，最终定位到是编译器优化差异导致。这提醒我们，关键业务系统不仅要备份源码，还应该保存构建环境和编译参数。