测试开机启动脚本保姆级教程，小白也能一次成功
你是不是也遇到过这样的问题：写好了测试脚本，想让它开机自动运行，结果试了几次都失败？终端没弹出来、脚本没执行、甚至系统启动变慢……别急，这不是你的问题，而是Linux开机自启机制本身就有多个入口，选错方法就容易踩坑。
这篇教程不讲抽象概念，不堆参数说明，只聚焦一件事：让你的test.sh在Ubuntu开机时稳稳当当地跑起来，而且是桌面环境就绪后才执行。全程用大白话+真实命令+关键提醒，连Linux新手也能照着操作，一次成功。
我们不搞“理论上可行”，只讲“实测能用”的方案。下面这三种方法，我都亲自在Ubuntu 22.04桌面版上反复验证过，每一步都标注了为什么这么写、哪里最容易出错、出错了怎么快速排查。
1. 最稳妥：用 GNOME 启动应用程序管理器（推荐新手首选）
这是对新手最友好的方式——它不碰系统级配置，不改权限，不涉及运行级别，所有操作都在图形界面里完成，失败了删掉重来也不影响系统。
1.1 先确认脚本能手动运行
别跳过这步！很多失败其实卡在脚本本身。
打开终端，执行：
bash /home/Desktop/test.sh你应该看到类似这样的输出：
file1.txt file2.jpg OK!如果报错No such file or directory或Permission denied，请先检查两点：
- 脚本路径是否正确？注意
/home/Desktop/中的Desktop首字母是大写，且用户名要替换成你自己的（比如/home/yourname/Desktop/） - 脚本是否有执行权限？运行
chmod +x /home/Desktop/test.sh补上
确认能手动运行，再继续下一步。
1.2 添加到“启动应用程序”
Ubuntu 桌面自带一个叫“启动应用程序”的工具，专门管开机自动运行的程序。
在终端中输入：
gnome-session-properties或者直接在应用菜单搜索“启动应用程序”并打开。
点击左下角的添加按钮，填写三项：
| 字段 | 填写内容 | 说明 |
|---|---|---|
| 名称 | 测试脚本 | 随便起个好记的名字，不影响功能 |
| 命令 | gnome-terminal -- bash -c "cd /home/Desktop && ./test.sh; exec bash" | 关键！见下方详解 |
| 注释 | 运行桌面测试脚本 | 可选，方便以后识别 |
注意：命令栏里一定要写完整，不能只写./test.sh，也不能漏掉exec bash。
为什么这样写？
gnome-terminal --：强制新开一个终端窗口（否则脚本后台静默执行，你看不到输出）bash -c "..."：让终端执行一串命令，而不是只运行一个文件cd /home/Desktop && ./test.sh：先进入脚本所在目录，再执行，避免路径错误; exec bash：让终端执行完脚本后不自动关闭，停在终端界面，方便你看到OK!输出
填完点添加，然后重启电脑试试。你会看到：登录进桌面后，自动弹出一个终端窗口，执行完ls列出文件，最后显示OK!，然后终端保持打开状态。
成功标志：终端弹出 + 有输出 + 不闪退。
1.3 常见问题速查
终端没弹出来？
检查是否开启了“自动登录”。进入“设置 → 用户 → 自动登录”，开启它。GNOME 启动管理器依赖用户会话，未登录时不会触发。弹出终端但没执行脚本？
打开“启动应用程序”，双击刚添加的条目，检查“命令”字段有没有被意外修改或截断。终端一闪而过？
一定是漏了exec bash。加上它，终端就不会执行完就关了。
2. 最通用：rc.local 方案（适合需要系统级启动的场景）
如果你的脚本不需要图形界面（比如只是备份日志、检测硬件状态），或者你想让它在登录前就运行，那rc.local是更底层、更通用的选择。
但注意：Ubuntu 22.04 默认禁用了 rc.local 服务，必须手动启用，否则写了也白写。
2.1 启用 rc.local 服务
先创建文件（如果不存在）：
sudo nano /etc/rc.local粘贴以下内容（注意保留#!/bin/sh -e和exit 0）：
#!/bin/sh -e # # rc.local # # This script is executed at the end of each multiuser runlevel. # Make sure that the script will exit 0 on success or any other # value on error. # Print the IP address # _IP=$(hostname -I) || true # if [ "$_IP" ]; then # printf "My IP address is %s\n" "$_IP" # fi # 👇 在这里添加你的命令（注意：路径必须绝对，不能用 ~） cd /home/Desktop && ./test.sh exit 0保存退出（Ctrl+O → Enter → Ctrl+X）。
然后给它执行权限：
sudo chmod +x /etc/rc.local最后启用服务：
sudo systemctl enable rc-local sudo systemctl start rc-local检查是否启用成功：
systemctl status rc-local如果看到active (exited)，说明已启用；如果报failed，常见原因是/etc/rc.local文件里有语法错误，或路径写错了（比如用了~/Desktop而不是/home/yourname/Desktop）。
2.2 重要提醒：rc.local 的执行时机
rc.local是在系统初始化完成、但用户还没登录时运行的。这意味着：
- ❌ 它看不到你的桌面环境（没有
$DISPLAY变量） - ❌ 无法直接调用
gnome-terminal、nautilus等图形程序 - ❌ 如果脚本里有
ls这种命令，它会执行，但你看不到输出（因为没终端）
所以，如果你的test.sh只是打印OK!，用rc.local是没问题的；但如果你想看到终端弹窗、或者脚本依赖图形界面（比如打开浏览器、调用 GUI 工具），那就不要选这个方案。
适合场景：后台服务、定时任务准备、硬件检测、日志清理等无界面任务。
3. 最传统：/etc/init.d + update-rc.d（了解即可，新手慎用）
这是 Debian/Ubuntu 早期的经典方式，现在官方已不推荐，但很多老教程还在用。它的逻辑是：把脚本放进系统服务目录，再用update-rc.d注册为“系统服务”。
它的问题很明确：太重、太绕、容易和 systemd 冲突，且对桌面脚本支持差。不过既然你看到了，我们就把它说透，避免你被网上过时教程带偏。
3.1 正确写法（不是简单复制粘贴）
首先，/etc/init.d/下的脚本不是普通 shell 脚本，它必须符合 LSB（Linux Standard Base）规范，包含标准头和start/stop函数。
你的test.sh不能直接扔进去。得改写成这样：
#!/bin/sh ### BEGIN INIT INFO # Provides: test-script # Required-Start: $local_fs $network # Required-Stop: $local_fs # Default-Start: 2 3 4 5 # Default-Stop: 0 1 6 # Short-Description: Run test script at boot # Description: This service runs /home/Desktop/test.sh at system startup. ### END INIT INFO case "$1" in start) echo "Starting test script..." cd /home/Desktop && ./test.sh ;; stop) echo "Stopping test script..." ;; *) echo "Usage: $0 {start|stop}" exit 1 ;; esac exit 0保存为/etc/init.d/test-script（注意名字不要带.sh），然后：
sudo chmod +x /etc/init.d/test-script sudo update-rc.d test-script defaults3.2 为什么新手不推荐？
- 你写的脚本必须严格遵循 init.d 规范，少一行注释头都可能注册失败
update-rc.d的defaults参数在新版 Ubuntu 上实际效果不稳定，常被 systemd 忽略- 即使注册成功，它也是在系统启动早期运行，同样看不到桌面、打不开终端
- 排查困难：日志分散在
/var/log/syslog里，新手很难定位
仅建议：你正在维护一个老旧服务器，或需要和传统 init 系统兼容时使用。
4. 三个方案对比与选择指南
光看文字可能还是拿不准该选哪个？我们用一张表帮你一眼看清区别：
| 对比项 | GNOME 启动应用程序 | rc.local | /etc/init.d |
|---|---|---|---|
| 适用人群 | 新手首选，完全图形化 | 有一定Linux基础 | ❌ 不推荐新手 |
| 是否需要图形界面 | 必须（登录后才运行） | ❌ 无界面（登录前运行） | ❌ 无界面（登录前运行） |
| 能否看到脚本输出 | 终端弹窗，清晰可见 | ❌ 后台运行，无输出 | ❌ 后台运行，无输出 |
| 配置难度 | 点几下鼠标+敲一条命令 | 需启用服务+注意路径 | ❌ 需改写脚本+理解init规范 |
| 失败风险 | 极低，删掉重来即可 | 权限/路径错误易导致启动慢 | ❌ 配置错误可能导致系统启动卡住 |
| 推荐场景 | 桌面脚本、调试脚本、需要反馈的脚本 | 后台任务、系统检测、无需交互的任务 | 老旧系统维护、兼容性要求高的环境 |
一句话决策建议：
- 你想开机后看到终端跑脚本 → 选第1种（GNOME）
- 你想脚本在后台默默干活，不打扰你 → 选第2种（rc.local）
- 你不是在维护老系统，就别碰第3种。
5. 故障排查清单：5分钟定位问题根源
即使按教程操作，偶尔也会失败。别慌，对照这份清单，5分钟内找到原因：
- 检查脚本路径：
/home/Desktop/中的Desktop是大写，且home后面是你的真实用户名（如/home/john/Desktop/）。用ls /home/*/Desktop/快速确认。 - 检查执行权限：运行
ls -l /home/Desktop/test.sh，确保有x（执行）权限。没有就补：chmod +x /home/Desktop/test.sh。 - 检查脚本第一行：必须是
#!/bin/bash或#!/bin/sh，不能是 Windows 换行（\r\n）。用file /home/Desktop/test.sh查看，如果显示CRLF，用dos2unix /home/Desktop/test.sh修复。 - 检查 GNOME 是否启用自动登录：没有自动登录，GNOME 启动管理器不会触发。这是新手最高频的遗漏点。
- 查看日志：如果用了
rc.local或init.d，运行sudo journalctl -u rc-local或sudo journalctl -u test-script查看错误详情。
记住：90% 的失败，都出在这五点里。逐条核对，比重装系统快得多。
获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。
