如何在Raspbian下实现Qt5 GUI Python脚本开机自启及桌面快捷启动？

一、解决可执行文件依赖原目录的问题 #

你用pyinstaller --onefile打包时，脚本依赖的资源文件（比如图片、配置）未被打包进可执行文件，导致必须和原脚本同目录才能运行。按以下步骤修复：

1. 修改脚本中的资源路径获取逻辑
   在你的Python脚本里添加一个资源路径获取函数，替换所有相对路径引用：

import sys
import os

def get_resource_path(relative_path):
    # 打包后从临时目录读取资源，未打包时从当前目录读取
    if hasattr(sys, '_MEIPASS'):
        return os.path.join(sys._MEIPASS, relative_path)
    return os.path.join(os.path.abspath("."), relative_path)

比如原来写open("config.ini")，改成open(get_resource_path("config.ini"))；引用图标时QIcon("icon.png")改成QIcon(get_resource_path("icon.png"))。

2. 重新打包时包含资源文件
   假设你的资源都在./resources目录下，用以下命令打包：

pyinstaller --onefile --add-data "resources:resources" your_script.py

如果是单个文件（比如icon.png），就用--add-data "icon.png:."。打包完成后，dist目录下的可执行文件就能独立运行，无需依赖原脚本目录。

二、去掉双击的选择提示并创建桌面快捷方式 #

在Raspbian上，通过创建.desktop桌面快捷方式解决：

1. 创建桌面快捷文件
   在桌面新建your_app.desktop文件，内容如下：

[Desktop Entry]
Type=Application
Name=你的应用名称 # 替换为你的应用名字
Exec=/home/pi/dist/your_executable # 替换为可执行文件的绝对路径
Icon=/home/pi/icon.png # 可选，替换为图标文件的绝对路径
Terminal=false # 关键设置，关闭终端选择提示
Comment=你的应用描述 # 可选，添加应用说明
Categories=Utility;Application;

2. 设置可执行权限
   打开终端执行命令，给快捷文件添加权限：

chmod +x ~/Desktop/your_app.desktop

之后双击桌面图标即可直接启动应用，不会再弹出选择提示。

三、顺带解决开机自启问题 #

如果仍需要开机自动启动应用，可通过Raspbian自带的启动设置添加：

• 打开系统菜单 → Preferences → Startup Applications
• 点击"Add"，在"Command"栏填入可执行文件的绝对路径（比如/home/pi/dist/your_executable），设置名称后保存即可。

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