Avalonia应用在Linux开机自启需两步：先配置系统自动登录用户，再通过.desktop文件添加至桌面启动项；须确保路径权限、工作目录及桌面环境兼容性。
Avalonia 应用本身不内置开机自启机制，需依赖操作系统层面配置。在 Linux（如 Ubuntu、银河麒麟、deepin）上实现开机自启，核心是两步：确保系统自动登录用户 + 让 Avalonia 程序随桌面环境启动。
确保桌面环境自动登录用户
这是 GUI 程序能自动运行的前提。若系统停留在登录界面，后续自启脚本不会执行。
- Ubuntu/GNOME 系统：进入“设置 → 用户 → 自动登录”，开启对应账户的自动登录（需账户无密码或已配置 PAM 允许无密登录）
- 银河麒麟/UKUI：在“控制中心 → 用户账户 → 登录选项”中启用“自动登录”
- 命令行快速验证：运行 loginctl show-session $(loginctl | grep -o 'session-[0-9]*' | head -1) -p Type，输出应为 Type=greeter（未登录）或 Type=x11（已登录桌面），后者才表示自动登录生效
添加 Avalonia 程序到桌面启动项
推荐使用标准的 .desktop 启动文件方式，兼容性好、无需额外依赖。
- 创建启动脚本（可选但推荐）：比如
~/bin/start-myapp.sh，内容为：
#!/bin/bash
cd /path/to/your/app
dotnet YourApp.dll &
然后执行 chmod +x ~/bin/start-myapp.sh - 创建 ~/.config/autostart/myapp.desktop（用户级，无需 root）：
[Desktop Entry]
Name=MyAvaloniaApp
Exec=/home/username/bin/start-myapp.sh
Type=Application
Hidden=false
NoDisplay=false
X-GNOME-Autostart-enabled=true - 保存后无需重启，下次登录桌面即生效；也可手动测试：gtk-launch myapp
~/bin/start-myapp.sh，内容为：注意事项与常见问题
部分情况会导致自启失败，需逐一排查：
- 路径权限问题：.dll 文件和启动脚本必须有可执行权限（chmod +x），且 dotnet 运行时已安装并可在 PATH 中调用
- 工作目录缺失：Avalonia 应用常依赖相对路径加载资源（如 Fonts、Assets），务必在 Exec 行中用 cd 切换到发布目录，或在代码中用 AppDomain.CurrentDomain.BaseDirectory 定位
- 桌面环境差异：KDE Plasma 默认读取 ~/.config/autostart/，GNOME 和 UKUI 也支持；若无效，可尝试将 .desktop 文件复制到 ~/.local/share/applications/ 并执行 update-desktop-database
- 日志调试：临时将 Exec 改为 Exec=sh -c 'dotnet /path/YourApp.dll >> /tmp/myapp.log 2>&1'，查看日志定位启动失败原因
不复杂但容易忽略的是：自动登录和桌面启动是两个独立环节，缺一不可。只要路径、权限、环境变量三者到位，Avalonia 应用就能稳稳地在开机后自己跑起来。
