PyArmor加密Python项目时解决相对导入问题的技术方案

在使用PyArmor对Python项目进行代码加密保护时，开发者可能会遇到一个典型的运行时错误："ImportError: attempted relative import with no known parent package"。这个问题通常发生在加密后的脚本尝试使用相对导入方式引用PyArmor运行时辅助模块时。本文将深入分析问题成因并提供两种实用的解决方案。

问题本质分析

当使用PyArmor的递归加密模式(-r参数)处理项目时，加密工具会自动生成名为"pyarmor_runtime_xxxxxx.py"的运行时辅助模块，并在加密脚本中添加相对导入语句(如"from ..pyarmor_runtime_000000 import pyarmor")。这种设计在包结构完整的项目中能正常工作，但在以下场景会出现问题：

1. 被加密脚本作为独立文件执行时，Python解释器无法识别其包位置
2. 项目目录结构不符合标准包规范
3. 运行环境与加密环境的路径不一致

解决方案一：调整加密方式

推荐采用非递归的目录级加密方案：

1. 对目标目录直接加密而不使用-r参数：

pyarmor obfuscate /data/test/

2. 这种加密方式会生成不带相对导入前缀的引用语句，如直接使用：

from pyarmor_runtime_000000 import __pyarmor__

3. 需要手动将运行时辅助模块复制到每个需要它的子目录中，可以通过编写部署脚本自动完成：

import shutil
import os

runtime_file = "pyarmor_runtime_000000.py"
for root, dirs, files in os.walk("dist"):
    if runtime_file not in files:
        shutil.copy(runtime_file, root)

解决方案二：改造项目结构

如果必须保持递归加密方式，可以重构项目结构：

1. 确保项目具有完整的__init__.py文件体系
2. 将被加密模块组织成标准Python包
3. 从包顶层入口执行脚本而非直接运行子模块

最佳实践建议

1. 对于简单项目，推荐使用方案一的目录级加密
2. 复杂项目应考虑建立标准的包结构并确保所有脚本通过包入口执行
3. 部署时注意保持加密环境与运行环境的路径一致性
4. 可以编写自动化部署脚本处理运行时模块的复制工作

通过理解PyArmor的模块引用机制并合理规划项目结构，开发者可以有效地避免相对导入问题，确保加密后的代码能够正确执行。