在 Python 开发中，将脚本打包成可执行文件（EXE）是分发程序的有效方式。但默认生成的 EXE 文件图标通常是普通的 Python 标志，缺乏个性化。添加自定义图标不仅能提升程序的专业度，还能增强品牌识别，给用户留下更深刻的印象。本文将基于 PyInstaller 工具（版本 5.x 或更高），介绍两种简单方法，帮助您轻松实现这一目标。
（一）准备工作
1.安装 PyInstaller：在命令行中运行pip install pyinstaller，确保已安装该工具。如果您之前已安装旧版本，可以使用pip install --upgrade pyinstaller命令进行更新 ，以获取最新功能和修复。
2.准备图标文件：图标必须是 Windows 标准的.ico 格式。如果您只有 PNG 或 JPG 图像，可使用在线工具（如 ICO Convert、迅捷图片转换器、比特虫等）将其转换为 ICO 文件。推荐尺寸为 256x256 像素以确保清晰度，这样在各种分辨率下都能清晰显示，避免出现模糊或失真的情况。将转换后的图标文件保存为my_icon.ico，并放在项目目录下，确保 PyInstaller 在打包时能够找到它。
（二）执行打包命令
使用 PyInstaller 的--onefile参数打包成单个 EXE，并添加--icon参数指定图标路径。例如，如果您的脚本是app.py，在命令行中运行以下命令：
pyinstaller --onefile --icon=my_icon.ico app.py
参数说明：
1.--onefile：生成单个 EXE 文件，便于分发。用户只需下载这一个文件，无需担心依赖文件的缺失，大大简化了程序的部署过程。
2.--icon=my_icon.ico：指定图标文件路径，若图标在当前目录，直接写文件名即可。如果图标文件在其他目录，则需要提供完整的路径，如--icon=C:\projects\my_project\my_icon.ico 。
3.app.py：您的 Python 脚本名称。
（三）结果验证与优缺点
1.打包完成后，在dist文件夹中找到生成的app.exe文件。双击运行或查看文件属性，确认图标已更新为自定义图标。如果图标未正确显示，可以检查命令行是否有报错信息，或者重新确认图标文件路径是否正确。
2.优点：操作简单，一行命令即可完成，适合初学者和简单项目快速打包。即使您对 Python 打包不太熟悉，按照上述步骤也能轻松为 EXE 文件添加自定义图标。
3.缺点：对图标路径准确性要求高，若路径错误，打包会失败，需确保图标文件存在且路径正确。此外，如果项目需要频繁修改图标或进行复杂的打包配置，这种方式可能不太灵活。
（一）生成初始 spec 文件
首先运行基础打包命令生成 spec 文件，在命令行中输入：
pyinstaller --onefile app.py
这会在当前目录创建app.spec文件，该文件是 PyInstaller 的配置文件，允许您定制打包细节。例如，如果您的项目依赖一些特定的第三方库，或者需要包含额外的资源文件，都可以在这个文件中进行配置。
（二）修改 spec 文件添加图标
用文本编辑器（如 VS Code 或 Notepad++）打开app.spec，在文件末尾找到EXE部分，添加icon参数。示例修改后内容如下：
# app.spec 文件示例block_cipher = Nonea = Analysis(['app.py'],pathex=[],binaries=[],datas=[],hiddenimports=[],hookspath=[],hooksconfig={},runtime_hooks=[],excludes=[],win_no_prefer_redirects=False,win_private_assemblies=False,cipher=block_cipher,noarchive=False)pyz = PYZ(a.pure, a.zipped_data, cipher=block_cipher)exe = EXE(pyz,a.scripts,a.binaries,a.zipfiles,a.datas,[],name='app',debug=False,bootloader_ignore_signals=False,strip=False,upx=True,upx_exclude=[],runtime_tmpdir=None,console=True, # 如果不需要控制台窗口，可改为 console=Falseicon='my_icon.ico' # 添加此行指定图标)
保存修改后的文件。
（三）重新打包与适用场景
1.运行命令基于 spec 文件打包：
pyinstaller app.spec
生成的 EXE 文件在dist文件夹中，图标已更新。
2. 适用场景：适合重复打包和复杂项目，可添加其他自定义设置，如资源文件、隐藏控制台窗口等，提供更精细的打包控制。例如，对于一个包含多个 Python 脚本、数据文件以及需要隐藏控制台窗口的 GUI 项目，通过编辑 spec 文件，可以一次性配置好所有打包参数，方便后续的多次打包操作。
3. 缺点：步骤稍多，需要手动编辑文件，对新手来说有一定学习成本。如果不小心修改了 spec 文件中的其他重要配置，可能会导致打包失败或程序运行异常 。
（一）图标格式与路径
1.必须使用.ico 格式的图标文件，这是 Windows 可执行文件支持的标准图标格式。确保图标文件放在 PyInstaller 可访问的位置，如项目根目录，在命令行或 spec 文件中使用相对路径即可，例如--icon=my_icon.ico。相对路径的使用可以提高脚本的可移植性，无论项目在哪个目录下运行，只要图标文件和脚本文件的相对位置不变，打包过程就能顺利进行。
2.若图标未显示，首先检查文件路径是否正确。路径错误是导致图标无法正常显示的常见原因之一，可能是由于拼写错误、目录层级错误等。可尝试将图标文件直接放在与脚本同目录下，避免使用复杂路径。这样可以简化路径的管理，减少因路径问题导致的错误 。
（二）跨平台与测试
1.PyInstaller 是跨平台工具，但生成的 EXE 主要针对 Windows 系统。在目标系统（如 Windows）上测试 EXE 文件，确认图标显示正常。不同操作系统对图标格式和显示方式的支持可能存在差异，即使在 Windows 系统下正常显示的图标，在其他操作系统上也可能无法正常显示。因此，在分发程序之前，务必在目标系统上进行充分测试。
2.如果图标未更新，可删除之前生成的 build 和 dist 目录，重新执行打包命令。这是因为 PyInstaller 在打包过程中可能会缓存一些旧的配置和文件，如果之前的打包过程中存在问题，缓存的文件可能会导致新的打包结果仍然不正确。删除 build 和 dist 目录可以确保 PyInstaller 重新生成所有文件，从而应用最新的图标设置 。
（三）其他工具简介
除了 PyInstaller，其他工具如 cx_Freeze 也支持类似功能，通过在 setup 函数中配置图标，示例代码如下：
from cx_Freeze import setup, Executablesetup(name = "MyApp",version = "0.1",description = "My Application",executables = [Executable("myscript.py", icon="my_icon.ico")])
auto - py - to - exe 是基于 PyInstaller 的图形界面工具，适合不熟悉命令行的用户，通过界面选择图标文件即可打包。其操作步骤如下：
1.安装 auto - py - to - exe：pip install auto - py - to - exe 。
2.启动工具：在命令行输入auto - py - to - exe ，会自动打开浏览器访问http://localhost:8000进入操作界面。
3.配置打包选项：在打开的图形界面中，选择 Python 脚本文件，勾选 “一个文件” 选项，并指定图标文件。点击 “转换.py 到.exe” 按钮开始打包。
但 PyInstaller 是最常用且便捷的选择，尤其适合本文介绍的两种核心方法。它具有强大的功能和广泛的社区支持，无论是简单项目还是复杂项目，都能轻松应对 。
通过以上两种方法，您可以轻松为 Python 打包的 EXE 文件添加个性化图标。命令行方法适合快速打包，简单直接；编辑 spec 文件的方法则提供了更多灵活性，适合需要复杂配置的项目。根据项目需求选择合适的方法，不仅能提升程序的外观，还能增强专业感和用户体验。快动手为您的程序换上专属图标吧！
