PYTHON / GETTING STARTED
Python 代码混淆
使用与排错指南
面向准备分发 Python 项目的开发者：先理解保护范围，再用项目副本验证处理结果。ZFJPyMix 提供 Windows 与 macOS 下载，免费提供 Python 源码混淆服务。
Python 混淆、Pyc 编译与打包有什么区别？
源码混淆改变代码的可读性；Pyc 编译生成 Python 字节码；打包则解决程序和依赖如何交付。它们处理的是不同问题，不能彼此替代。
| 方式 | 主要作用 | 需要注意 |
|---|---|---|
| 代码混淆 | 改变变量、类名、方法名或文件名，增加直接分析的成本。 | 动态引用与对外接口可能依赖原名称，必须测试。 |
| Pyc 编译 | 把源码转换为 Python 字节码文件。 | 不是不可逆加密，仍可能被反编译；需验证目标解释器兼容性。 |
| 应用打包 | 组织程序与运行依赖，便于分发。 | 打包不等于混淆。本页不宣称 ZFJPyMix 提供独立应用打包功能。 |
首次使用：从源码备份到运行验证
- 保留可运行的原始项目。先保存源码副本或版本控制快照，并记录当前 Python 版本、依赖和启动命令。
- 下载对应系统版本。在项目副本上操作，先查看项目说明。不要直接覆盖唯一源码。
- 选择项目和处理选项。ZFJPyMix 提供标识与文件名混淆、注释清理、Pyc 编译。首次建议分项验证，避免一次改变太多因素。
- 识别必须保留的名称。检查动态导入、反射、插件入口、序列化字段与外部调用接口。仅对已确认可以安全改名的范围启用处理；需要保留名称时，先核实当前版本的忽略设置。
- 在目标环境运行。验证启动、模块导入、核心业务、资源读取及第三方调用，并对照原始副本排查差异。
标识混淆后，代码会是什么样？
下面是概念示例，展示名称变化，而非当前版本的固定输出。示例未加密字符串，也不代表增加了运行时安全边界。
处理前
def calculate_total(price, count):
return price * count处理后（概念示例）
def py_a7m9(v_k3p1, v_x8n2):
return v_k3p1 * v_x8n2如果其他程序仍通过 calculate_total 调用这个接口，改名后就可能失败。应保留对外接口名称或同步调整调用方，不能只验证这段函数本身。
混淆后无法运行，如何排查？
出现 ModuleNotFoundError 或 ImportError
对照原始副本检查包结构、相对导入和启动目录。文件名变化可能影响导入；先关闭文件名混淆复测，再缩小到具体模块。不要通过反复全量混淆来覆盖排错线索。
动态导入、getattr 或插件找不到名称
importlib.import_module("package.module") 与 getattr(obj, "method_name") 中的字符串可能依赖原始标识。检查字符串引用与注册入口，保留必要名称，并核实当前版本可用的忽略方式。
资源文件或配置文件找不到
检查文件路径拼接、工作目录和随程序分发的资源。分别验证源码目录与交付目录，不把文件名混淆误认为资源路径会自动完成全部适配。
Pyc 在另一台机器上无法运行
记录生成与运行两端的 Python 解释器版本和依赖。不要假设任意版本可以互通；优先在目标环境中生成和验证字节码。项目没有公布的最低 Python 或系统版本，本页不作推测。
如何向作者反馈问题？
提供操作系统、Python 版本、工具版本、所选功能、完整报错以及可复现的最小示例。先移除密钥、客户数据与商业源码；通过首页联系方式沟通即可。
下载 ZFJPyMix 与确认版本
请根据桌面系统选择 Windows 或 macOS 版本。下载包的当前版本、系统最低要求及具体功能适配，以项目说明和实际软件为准。