如何使用Pyarmor结合虚拟环境打包Python代码并解决相关报错

基础环境校验 #

• 确认当前终端已正确激活虚拟环境，执行pyarmor --version和which pyarmor（Windows执行where pyarmor），验证Pyarmor路径指向虚拟环境目录而非全局环境
• 执行pip list核对所有项目依赖均已安装在当前虚拟环境中，版本与项目要求一致

打包命令修正 #

90%以上的"run command failed"报错是因为Pyarmor混淆后默认调用全局Python解释器，和虚拟环境依赖不匹配导致
打包时需要显式指定虚拟环境的解释器路径，参考以下示例（将示例中的虚拟环境目录、入口脚本、资源路径替换为你自己的项目内容）：

• 普通混淆打包（输出目录为dist）
  Linux/macOS：pyarmor gen --python venv/bin/python main.py
  Windows：pyarmor gen --python venv\Scripts\python.exe main.py
• 单文件可执行程序打包
  Linux/macOS：pyarmor gen --onefile --python venv/bin/python --add-data "assets/*:assets/" main.py
  Windows：pyarmor gen --onefile --python venv\Scripts\python.exe --add-data "assets/*;assets/" main.py

依赖搜索路径配置 #

如果调整命令后仍提示依赖缺失，将虚拟环境的第三方包路径添加到Pyarmor的搜索配置中：

• Windows：pyarmor cfg append pyinstaller:paths "venv\Lib\site-packages"
• Linux/macOS：pyarmor cfg append pyinstaller:paths "venv/lib/python3.x/site-packages"（将3.x替换为你当前虚拟环境的Python版本号）

缓存清理与调试 #

• 每次打包前删除之前生成的dist、build文件夹和__pycache__缓存目录，避免旧缓存干扰
• 打包时添加--debug参数输出完整执行日志，可定位具体失败步骤：pyarmor gen --debug --python venv/bin/python main.py

特殊情况处理 #

• 若使用Pyarmor 8.x及以上专业版，需先激活许可再执行打包操作，试用版无需额外配置
• 若提示权限错误，Windows下使用管理员身份启动终端执行命令，Linux/macOS下执行chmod -R 755 venv给虚拟环境目录授予执行权限

内容的提问来源于stack exchange，提问作者ahmad.arafa