如何用PyInstaller构建兼容WSLg的VMAF可视化可执行文件？

1. 强制打包Matplotlib全量依赖 #

PyInstaller默认可能遗漏Matplotlib的后端组件，用--collect-all参数强制打包全部相关文件：

# 单文件模式
pyinstaller --onefile --collect-all matplotlib your_script.py

# 若单文件仍有问题，尝试更稳定的目录模式
pyinstaller --onedir --collect-all matplotlib your_script.py
# 将生成的可执行文件软链到/usr/local/bin实现全局调用
sudo ln -s $(pwd)/dist/your_script/your_script /usr/local/bin/vmaf-grapher

2. 显式指定Matplotlib后端 #

在代码开头添加后端指定，确保WSLg能正常识别渲染环境：

import matplotlib
# 优先使用TkAgg（需提前安装依赖），也可替换为Qt5Agg
matplotlib.use('TkAgg')

安装对应后端的系统依赖：

# Tk后端依赖
sudo apt install python3-tk libtk8.6
# Qt后端依赖（可选）
sudo apt install python3-pyqt5 libqt5gui5

3. 用Shell脚本封装执行环境 #

打包后的程序可能无法自动继承WSLg的环境变量，通过脚本补全：

1. 创建脚本文件/usr/local/bin/vmaf-grapher：

#!/bin/bash
# 导出WSLg必需的环境变量
export DISPLAY=$DISPLAY
export WAYLAND_DISPLAY=$WAYLAND_DISPLAY
export XDG_RUNTIME_DIR=$XDG_RUNTIME_DIR
export PULSE_SERVER=$PULSE_SERVER
# 指向PyInstaller生成的可执行文件路径
/path/to/your/dist/executable "$@"

2. 给脚本添加执行权限：

sudo chmod +x /usr/local/bin/vmaf-grapher

4. 替换打包工具为cx_Freeze #

若PyInstaller兼容性问题无法解决，尝试用cx_Freeze打包：

1. 安装cx_Freeze：

pip install cx_Freeze

2. 创建setup.py配置文件：

import sys
from cx_Freeze import setup, Executable

target = Executable(
    script="your_script.py",
    base=None,
    target_name="vmaf-grapher"
)

setup(
    name="vmaf-grapher",
    version="1.0",
    description="VMAF Report Visualizer",
    executables=[target]
)

3. 生成可执行文件并全局调用：

python setup.py build
# 软链到/usr/local/bin
sudo ln -s $(pwd)/build/exe.linux-x86_64-3.x/vmaf-grapher /usr/local/bin/

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