PyInstaller透明PNG启动界面出现粉色边框问题求助

问题描述 #

使用PyInstaller内置splash功能打包Python脚本为EXE，代码如下：

if getattr(sys, 'frozen', False):
    import pyi_splash
    pyi_splash.close()

功能正常，但透明PNG启动界面边缘出现细微粉色边框；使用带背景的JPG无此问题。PNG由Figma导出，直线区域粉色边框比曲线/角度区域更不明显。

解决方法 #

这个问题并非单纯需要"像素完美"，核心是PyInstaller的splash组件对透明PNG的Alpha通道渲染兼容性问题，结合Figma导出设置和图片预处理即可解决：

• 调整Figma导出参数

  1. 导出时选择PNG-24格式（带完整Alpha通道），避免使用PNG-8（索引色透明易出现色边）
  2. 取消勾选「包含颜色配置文件」，PyInstaller的splash渲染对ICC配置文件兼容性较差，易导致色偏
  3. 开启「像素对齐（Pixel Perfect）」，避免曲线/圆角区域的抗锯齿像素与Figma画布底色混合，导出后被PyInstaller误渲染

• 预处理PNG图片
  用Photoshop、GIMP或免费在线工具Photopea打开图片：

  1. 进入通道面板选中Alpha通道，用「色阶工具」拉高半透明区域对比度，减少模糊过渡像素
  2. 对Alpha通道做1像素以内的「收缩」处理，清除边缘弱透明像素
  3. 检查边缘像素，确保没有残留Figma画布底色（若画布曾设为粉色，抗锯齿边缘会混入该颜色）

• 修改PyInstaller打包配置

  1. 命令行打包时添加背景色参数，匹配软件窗口背景色：

     pyinstaller --splash your_splash.png --splash-background-color white your_script.py
     

  2. 若使用spec文件，在Splash配置中添加背景色：

     Splash('your_splash.png', background_color='white')
     

     半透明边缘会与指定背景色混合，消除粉色边框

• 替代方案
  若上述方法无效，可改用PyQt/customtkinter自定义启动界面，自行控制透明PNG渲染，避开PyInstaller内置splash的兼容性问题

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