PyInstaller打包时__init__.py解析sys.argv引发异常的解决方法

问题根源 #

PyInstaller打包过程中会启动隔离进程分析依赖，此时会导入所有依赖包并执行其__init__.py的顶层代码。这一阶段的sys.argv是PyInstaller自身的进程参数（如isolated_child.py、端口号等），而非最终用户运行程序时的参数，导致你的参数检查逻辑误触发。

解决方案 #

方案1：将参数检查逻辑移至函数，由主程序按需调用

把__init__.py中的顶层检查代码封装成函数，仅在主程序运行时调用，避免导入阶段执行：

修改dep/__init__.py：

# dep/__init__.py
import sys

expected_args = ['--arg']

def check_args():
    for arg in sys.argv:
        if arg not in expected_args:
            print(f"Got unexpected arg: {arg}")

修改main.py：

# main.py
import dep
if __name__ == '__main__':
    dep.check_args()
    print("hello world")

方案2：添加条件判断，仅在主程序运行时执行检查

在__init__.py中增加判断逻辑，仅当程序处于用户运行阶段而非PyInstaller打包阶段时，才执行参数检查：

修改dep/__init__.py：

# dep/__init__.py
import sys

expected_args = ['--arg']

# 仅当主程序是当前运行入口时执行检查
if sys.argv[0].endswith(('main.py', 'main.exe')):
    for arg in sys.argv:
        if arg not in expected_args:
            print(f"Got unexpected arg: {arg}")

方案3：解耦依赖，由主程序传入参数

让dep包不再直接读取sys.argv，而是由主程序传入需要检查的参数，彻底避免打包阶段的参数冲突：

修改dep/__init__.py：

# dep/__init__.py
expected_args = ['--arg']

def check_args(args):
    for arg in args:
        if arg not in expected_args:
            print(f"Got unexpected arg: {arg}")

修改main.py：

# main.py
import dep
import sys
if __name__ == '__main__':
    dep.check_args(sys.argv)
    print("hello world")

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