如何创建可跨Python3版本安装的编译型Python源码保护包

你遇到的bad magic number错误，本质是.pyc字节码与Python版本强绑定——每个Python3小版本的字节码都有专属的magic number，跨版本加载时就会触发识别失败。以下是几种可行的解决方案：

方案1：用Cython编译为二进制扩展（推荐） #

这是兼顾源码保护与跨Python3版本兼容性的最可靠方案。编译后的二进制文件（Linux为.so、Windows为.pyd）可在同架构的多数Python3版本中运行，且几乎无法反编译出可读源码。

操作步骤： #

1. 安装Cython：

   pip install cython
   

2. 修改setup.py，将需要保护的Python模块指定为Cython扩展：

   from setuptools import setup, Extension
   from Cython.Build import cythonize
   
   # 列出所有需要编译的模块，格式为"包名.模块名": ["模块文件路径"]
   extensions = [
       Extension("myproject.core", ["myproject/core.py"]),
       Extension("myproject.utils", ["myproject/utils.py"]),
       # 按需添加更多模块
   ]
   
   setup(
       name="myproject",
       version="0.0.0",
       ext_modules=cythonize(
           extensions,
           compiler_directives={"language_level": "3"}  # 指定兼容Python3语法
       ),
       # 保留原setup配置，比如packages、install_requires等
   )
   

3. 生成兼容的wheel包：

   python setup.py bdist_wheel
   

注意事项： #

• 需为不同操作系统（Linux/Windows/macOS）单独编译对应wheel；
• 若代码依赖特定Python API，需在目标版本中测试兼容性，Cython默认支持Python3.6+。

方案2：打包多版本.pyc（应急方案，不推荐） #

若不想使用Cython，可提前为多个Python3版本生成对应.pyc，让安装时自动匹配版本，但维护成本高且兼容性有限：

1. 用目标Python版本分别生成.pyc：

   # 示例：为Python3.8、3.9、3.10生成字节码
   python3.8 -m compileall -b myproject/
   python3.9 -m compileall -b myproject/
   python3.10 -m compileall -b myproject/
   

2. 打包时将所有版本的__pycache__目录或版本标识的.pyc文件（如core.cpython-38.pyc）包含进wheel；
3. Python会自动加载与当前版本匹配的.pyc文件。

此方案的缺点：包体积增大，无法覆盖所有Python3版本，且仍有被反编译的风险。

方案3：字节码混淆（轻度保护） #

若仅需轻度源码保护，可使用pyarmor这类字节码混淆工具，混淆后的字节码仍能跨Python3版本运行：

1. 安装pyarmor：

   pip install pyarmor
   

2. 混淆目标模块：

   pyarmor obfuscate --recursive myproject/
   

3. 基于混淆后的文件配置setup.py并打包wheel，具体可参考pyarmor官方文档的打包指引。

此方案保护强度低于Cython，但胜在操作简单，无需修改代码结构。

内容的提问来源于stack exchange，提问作者StaticName