Python打包exe后右键菜单拖多文件触发多终端及sys.argv参数处理问题

出现该问题的核心原因是Windows右键菜单的注册表配置错误，默认配置只会传递单个选中文件参数、触发多进程启动，按以下步骤调整即可：

1. 修正注册表配置 #

打开注册表编辑器，定位到你添加的右键菜单对应的command项，一般路径为HKEY_CLASSES_ROOT\*\shell\你的自定义菜单名称\command（如果是针对特定后缀的文件菜单，替换*为对应后缀即可）。

• 如果你是选中文件后右键触发菜单，将command项的默认值从原来的你的exe路径 "%1"修改为 你的exe路径 "%*"，%*是Windows的多参数传递标识符，会把所有选中的文件路径作为完整参数列表传给同一个exe进程，不会重复启动。
• 如果你是在资源管理器空白处右键触发菜单、需要传递当前目录下选中的所有文件，将command项的默认值修改为 你的exe路径 "%V"即可。

2. 验证程序参数处理逻辑 #

调整注册表前先确认你的Python程序和打包配置没有问题：

• PyInstaller打包时不需要额外加特殊参数，只要保证程序本身支持接收多参数即可，可以用以下测试代码验证参数接收逻辑：

import sys
if __name__ == '__main__':
    # sys.argv[0]是exe本身路径，从索引1开始就是传入的文件路径
    print(f"共接收到{len(sys.argv)-1}个文件路径：")
    for path in sys.argv[1:]:
        print(path)
    input("按回车退出")

• 打包后手动打开CMD，执行你的exe路径 测试文件1路径 测试文件2路径，确认程序能一次性拿到所有传入的路径，再去调整注册表配置。

3. 兜底方案 #

如果以上配置后仍有问题，可通过单实例进程实现参数汇总：

• 程序启动时先检测是否存在同程序的运行实例，若存在则通过Windows命名管道、消息队列等进程间通信方式把当前拿到的文件路径传给已运行的实例，自身直接退出；若不存在则作为主实例运行，接收后续传入的所有路径汇总处理。

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