PySimpleGUI任务栏图标合并问题分析与解决方案

问题背景

在使用PySimpleGUI开发Windows应用程序时，开发者发现通过PyInstaller打包生成的多个EXE文件在任务栏上会共享同一个图标，而不是各自显示独立的图标。这个问题在PySimpleGUI 4.57.0版本中不存在，但从4.58.0版本开始出现。

问题现象

当开发者使用PySimpleGUI 4.58.0及更高版本时，会出现以下现象：

1. 多个不同应用程序的EXE文件在任务栏上显示相同的图标
2. 任务栏图标默认显示为PySimpleGUI的默认图标（非开发者指定的自定义图标）
3. 只有将应用程序固定到任务栏后，才会显示正确的自定义图标

根本原因分析

经过深入分析，发现问题的根源在于PySimpleGUI代码中设置Windows应用ID(AppID)的方式。在PySimpleGUI 4.58.0及更高版本中，添加了以下代码：

# 在Windows任务栏上显示正确的应用程序图标
if running_windows():
    try:
        myappid = 'mycompany.myproduct.subproduct.version'  # 固定字符串
        ctypes.windll.shell32.SetCurrentProcessExplicitAppUserModelID(myappid)
    except Exception as e:
        print('Error using the taskbar icon patch', e)

这段代码将所有PySimpleGUI应用程序的AppID设置为相同的固定字符串"mycompany.myproduct.subproduct.version"。Windows系统会根据AppID来决定是否合并任务栏图标，相同的AppID会导致系统认为这些应用程序属于同一组，从而合并它们的任务栏图标。

解决方案

临时解决方案

对于急需解决问题的开发者，可以采用以下临时方案：

1. 回退到PySimpleGUI 4.57.0版本
2. 或者手动移除上述代码段（约26287-26293行）

官方推荐解决方案

在PySimpleGUI 5.0.5及更高版本中，官方提供了更优雅的解决方案：

1. 设置唯一AppID：开发者可以在自己的代码中为每个应用程序设置唯一的AppID

import PySimpleGUI as sg

# 为应用程序设置唯一的AppID
sg.ctypes.windll.shell32.SetCurrentProcessExplicitAppUserModelID('your_unique_app_id')

# 后续窗口创建代码...

2. 通过sg.options设置：也可以通过全局选项设置AppID

sg.options(win_app_id='your_unique_app_id')

3. Base64编码图标：为了避免图标文件路径问题，建议将图标文件Base64编码后直接嵌入代码中

icon = b'base64编码的图标数据'
window = sg.Window('Title', layout, icon=icon)

深入技术解析

Windows AppID机制

Windows系统使用AppUserModelID（简称AppID）来标识应用程序。这个机制允许：

1. 控制任务栏图标分组行为
2. 管理跳转列表(Jump List)
3. 控制任务栏按钮的合并方式

当多个EXE使用相同的AppID时，Windows会认为它们属于同一个应用程序家族，从而合并它们的任务栏图标。

PyInstaller打包注意事项

在使用PyInstaller打包时，开发者需要注意：

1. 图标文件包含：确保自定义图标文件被正确包含在打包后的EXE中
2. 工作目录设置：检查快捷方式的"起始位置"设置，确保程序能找到图标文件
3. 单文件模式影响：--onefile模式下，资源文件会被解压到临时目录，可能导致路径问题

最佳实践建议

1. 为每个应用程序设置唯一AppID：避免图标合并问题
2. 内嵌图标资源：使用Base64编码将图标直接嵌入代码，避免文件路径问题
3. 测试不同环境：在开发环境和打包后环境中都测试图标显示效果
4. 使用psgshortcut工具：创建快捷方式时确保正确设置工作目录
5. 明确指定窗口图标：即使EXE文件已有图标，也应在Window创建时明确指定

总结

PySimpleGUI任务栏图标合并问题源于Windows AppID机制和PySimpleGUI默认设置的交互。通过理解底层机制并采用正确的设置方法，开发者可以完全控制应用程序在任务栏上的显示行为。最新版本的PySimpleGUI已提供更灵活的AppID设置方式，开发者应根据实际需求为每个应用程序配置合适的标识。