PyInstaller用--add-data打包后os.system调用aria2c命令失效

这个报错不是aria2c没被正确打包，是--onefile模式的运行机制导致的：单文件exe运行时会把所有--add-data引入的附属文件解压到系统临时目录下随机命名的_MEIxxxxxx文件夹（可通过sys._MEIPASS获取该路径），你直接调用aria2c时，系统只会检索当前工作目录、PATH环境变量包含的路径，根本不会访问这个临时解压目录，自然找不到程序。

1. 代码层面动态拼接aria2c的完整路径（最稳妥，优先使用） #

不要裸写aria2c命令，先根据运行环境拼出可执行文件的实际路径再调用，同时兼容开发环境和打包后的环境：

import os
import sys

def get_resource_path(relative_path):
    # 区分打包环境/开发环境的资源根路径
    if getattr(sys, 'frozen', False):
        base_path = sys._MEIPASS
    else:
        base_path = os.path.dirname(os.path.abspath(__file__))
    return os.path.join(base_path, relative_path)

# 获取aria2c的实际路径，Windows下要补.exe后缀
if sys.platform.startswith('win'):
    aria2c_exe = get_resource_path('aria2c.exe')
else:
    aria2c_exe = get_resource_path('aria2c')

# 调用时用完整路径，路径外层加引号兼容带空格的路径
os.system(f'"{aria2c_exe}" -x 16 -s 16 example.com')

2. 确认打包参数配置正确 #

--add-data参数的写法要符合系统规则，确保aria2c被解压到临时目录的根路径，和上面代码的拼接逻辑对应：

• Windows系统用分号分隔本地路径和打包内路径：--add-data "你本地存放aria2c.exe的绝对路径;."
• macOS/Linux系统用冒号分隔：--add-data "你本地存放aria2c的绝对路径:."

如果是修改spec文件打包，直接编辑Analysis里的datas字段即可，不需要加其他特殊配置：

a = Analysis(
    # 其他配置保持不变
    datas=[
        # 元组第一个元素是本地aria2c路径，第二个是打包内的存放路径，填.代表根目录
        ("C:/your/local/path/aria2c.exe", ".")
    ],
)

3. 临时方案：动态添加PATH #

如果不想修改原有调用命令，可以在调用aria2c前把临时解压目录加到系统PATH里：

import os
import sys
if getattr(sys, 'frozen', False):
    os.environ['PATH'] = f"{sys._MEIPASS}{os.pathsep}{os.environ['PATH']}"

# 之后可以直接用原来的os.system('aria2c -x 16 -s 16 example.com')调用

注意：这个方案在临时目录路径包含特殊字符时可能出现调用异常，优先选择第一种拼接完整路径的方案。

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