如何使用 PyInstaller Extractor 快速提取 Python 可执行文件内容：完整指南

【免费下载链接】pyinstxtractor PyInstaller Extractor 项目地址: https://gitcode.com/gh_mirrors/py/pyinstxtractor

PyInstaller Extractor 是一款强大的 Python 脚本工具，能够帮助开发者和用户轻松提取由 PyInstaller 生成的可执行文件内容。无论是分析第三方应用、恢复丢失的源代码，还是学习 Python 打包机制，这款工具都能提供高效解决方案。

什么是 PyInstaller Extractor？

PyInstaller Extractor 是一个轻量级 Python 脚本，专门用于解析和提取 PyInstaller 打包的可执行文件。它能够自动修复提取出的 .pyc 文件头，确保字节码反编译器能够正确识别，支持 Python 2.x 和 3.x 环境，兼容 PyInstaller 2.0 到 6.16.0 的所有主流版本。

该工具无需安装 PyInstaller 即可独立运行，通过解析可执行文件中的 CArchive 和 PYZ 归档结构，将打包的 Python 模块、资源文件和依赖项完整提取出来。

核心功能与优势

• 广泛兼容性：支持 PyInstaller 2.0 至 6.16.0 的所有版本，经过严格测试确保稳定运行
• 自动化修复：自动修复提取出的 .pyc 文件头，解决字节码反编译问题
• 跨平台支持：可处理 Windows、Linux 等系统的可执行文件，包括 ELF 格式
• 简单易用：无需复杂配置，一条命令即可完成提取过程
• 完整提取：不仅提取 Python 代码，还能恢复资源文件和依赖库

准备工作：安装与环境要求

使用 PyInstaller Extractor 前，只需准备：

1. Python 环境（2.x 或 3.x 均可）
2. 待提取的 PyInstaller 打包可执行文件

获取工具的方法很简单，通过 Git 克隆仓库：

git clone https://gitcode.com/gh_mirrors/py/pyinstxtractor

进入项目目录：

cd pyinstxtractor

一步到位：使用方法详解

基本提取命令

在命令行中执行以下命令，将 <filename> 替换为实际可执行文件路径：

python pyinstxtractor.py <filename>

例如提取名为 test.exe 的文件：

python pyinstxtractor.py test.exe

提取过程解析

执行命令后，工具将自动完成以下步骤：

1. 分析可执行文件，识别 PyInstaller 版本和 Python 版本
2. 定位并解析 CArchive 结构，提取其中包含的文件列表
3. 创建以 [文件名]_extracted 命名的目录，存放提取结果
4. 解析 PYZ 归档，提取其中的 Python 模块
5. 自动修复 .pyc 文件头，确保可被反编译器识别

提取结果示例

成功执行后，会看到类似以下输出：

[+] Processing test.exe
[+] Pyinstaller version: 2.1+
[+] Python version: 3.6
[+] Length of package: 5612452 bytes
[+] Found 59 files in CArchive
[+] Beginning extraction...please standby
[+] Possible entry point: pyiboot01_bootstrap.pyc
[+] Possible entry point: test.pyc
[+] Found 133 files in PYZ archive
[+] Successfully extracted pyinstaller archive: test.exe

You can now use a python decompiler on the pyc files within the extracted directory

提取的文件会保存在 test.exe_extracted 目录中，包含：

• 可执行文件的入口脚本（.pyc）
• 所有依赖的 Python 模块
• 资源文件和数据
• PYZ 归档提取的子目录

高级应用：处理不同场景

提取 Linux ELF 可执行文件

PyInstaller Extractor 原生支持 Linux ELF 格式的可执行文件，使用方法与 Windows 版本完全相同：

python pyinstxtractor.py linux_application

工具会自动识别文件格式并进行相应处理，无需额外配置。

反编译提取的 .pyc 文件

提取完成后，可以使用 Python 反编译工具如 Uncompyle6 或 Decompyle++ 将 .pyc 文件转换为可读的 Python 代码：

uncompyle6 test.exe_extracted/test.pyc

对于 PYZ 归档中提取的模块：

uncompyle6 test.exe_extracted/PYZ-00.pyz_extracted/__future__.pyc

处理加密的 PYZ 归档

如果遇到加密的 PYZ 归档，工具会提示并将内容以加密状态保存，文件名会添加 .encrypted 后缀。这些文件需要额外的解密步骤才能进一步处理。

常见问题与解决方案

Q: 提取过程中出现 "Unmarshalling FAILED" 错误怎么办？

A: 这通常是由于运行脚本的 Python 版本与打包可执行文件的 Python 版本不一致导致的。建议使用与目标可执行文件相同版本的 Python 重新运行提取命令。

Q: 提取后的 .pyc 文件无法被反编译器识别？

A: PyInstaller Extractor 会自动修复 .pyc 文件头，但某些特殊情况下可能需要手动检查。确保使用最新版本的提取工具，并尝试不同的反编译工具。

Q: 提取大型可执行文件时效率低下？

A: 对于特别大的文件，可尝试分阶段提取：先提取 CArchive，再单独处理 PYZ 归档，或者增加系统内存和临时存储空间。

总结与扩展资源

PyInstaller Extractor 是 Python 开发者和逆向工程师的实用工具，它提供了一种简单高效的方式来解析和提取 PyInstaller 打包的可执行文件。通过本文介绍的方法，您可以轻松获取打包在可执行文件中的 Python 代码和资源。

除了基础版本外，还有以下扩展项目值得关注：

• pyinstxtractor-ng：独立二进制版本，无需 Python 环境即可运行，支持加密可执行文件
• pyinstxtractor-web：基于 Go 和 GopherJS 的网页版，可在浏览器中直接使用

无论您是需要恢复丢失的代码、分析第三方应用，还是学习 PyInstaller 的工作原理，PyInstaller Extractor 都是一个值得掌握的实用工具。

许可证信息

PyInstaller Extractor 采用 GNU General Public License v3.0 许可证，源代码可自由获取和修改，详情参见项目根目录下的 LICENSE 文件。

【免费下载链接】pyinstxtractor PyInstaller Extractor 项目地址: https://gitcode.com/gh_mirrors/py/pyinstxtractor