# /boot/grub/grub.cfg — 自动生成的示例结构
#
# --- 头部区域 ---
# 设置默认项、超时、主题等
set default=0
set timeout=5
set menu_color_normal=white/black
set menu_color_highlight=black/light-gray

# 加载模块
loadfont unicode
set gfxmode=auto
insmod all_video
insmod gfxterm
terminal_output gfxterm

# --- 菜单区域 ---
menuentry 'Debian GNU/Linux' --class debian --class gnu-linux --class gnu --class os {
    load_video
    insmod gzio
    insmod part_gpt
    insmod ext2
    set root='hd0,gpt2'
    search --no-floppy --fs-uuid --set=root xxxx-xxxx-xxxx
    linux   /boot/vmlinuz-6.1.0-amd64 root=UUID=xxxx-xxxx ro quiet splash
    initrd  /boot/initrd.img-6.1.0-amd64
}

menuentry 'Windows Boot Manager' --class windows --class os {
    insmod part_gpt
    insmod fat
    set root='hd0,gpt1'
    search --no-floppy --fs-uuid --set=root XXXX-XXXX
    chainloader /EFI/Microsoft/Boot/bootmgfw.efi
}

# 设置变量
set my_var="hello world"
set default=0
set timeout=5

# 引用变量
echo $my_var
echo ${my_var}

# 特殊变量
# default     — 默认启动项编号
# timeout     — 超时时间（秒）
# fallback    — 默认项失败后的回退项
# gfxmode     — 图形模式分辨率
# gfxpayload  — 传递给内核的图形模式
# root         — 根设备
# prefix       — GRUB 配置文件所在目录

# 基本 if-else
if [ -f /boot/grub/grubenv ]; then
    load_env
fi

# 比较操作
if [ ${default} = 0 ]; then
    set timeout=10
else
    set timeout=30
fi

# 检查变量是否已设置
if [ "${grub_platform}" = "efi" ]; then
    insmod efi_gop
fi

# 检查文件是否存在
if [ -f ${prefix}/themes/mytheme/theme.txt ]; then
    set theme=${prefix}/themes/mytheme/theme.txt
fi

# for 循环
for v in 0 1 2 3; do
    echo "Testing mode $v"
done

# while 循环（少见用法）
set i=0
while [ $i -lt 10 ]; do
    set i=$((i + 1))
done

# 定义函数
function load_video {
    if [ x$feature_platform_search_hint = xy ]; then
        search --no-floppy --fs-uuid --set=root XXXX-XXXX
    fi
    insmod efi_gop
    insmod efi_uga
    insmod video_bochs
    insmod video_cirrus
    insmod all_video
}

# 调用函数
load_video

menuentry '显示名称' [选项] {
    # 菜单项内容
    ...
}

menuentry 'Debian GNU/Linux' --class debian --class gnu-linux --class gnu --class os --unrestricted {
    # 加载视频驱动
    load_video
    insmod gzio

    # 加载文件系统模块
    insmod part_gpt
    insmod ext2

    # 设置根设备（使用 UUID 更可靠）
    search --no-floppy --fs-uuid --set=root 1234-5678-abcd-efgh

    # 加载内核
    # ro: 以只读方式挂载根分区
    # quiet: 减少启动信息
    # splash: 显示启动画面
    linux /boot/vmlinuz-6.1.0-amd64 root=UUID=1234-5678-abcd-efgh ro quiet splash

    # 加载初始内存盘
    initrd /boot/initrd.img-6.1.0-amd64
}

submenu 'Advanced options for Debian' --class debian --class gnu-linux {
    menuentry 'Debian GNU/Linux, with Linux 6.1.0-amd64' {
        linux /boot/vmlinuz-6.1.0-amd64 root=UUID=xxx ro
        initrd /boot/initrd.img-6.1.0-amd64
    }

    menuentry 'Debian GNU/Linux, with Linux 6.1.0-amd64 (recovery mode)' {
        linux /boot/vmlinuz-6.1.0-amd64 root=UUID=xxx ro single
        initrd /boot/initrd.img-6.1.0-amd64
    }
}

# 正常启动（推荐）
linux /boot/vmlinuz root=UUID=xxx ro quiet splash

# 调试模式
linux /boot/vmlinuz root=UUID=xxx ro debug loglevel=7

# 安全/恢复模式
linux /boot/vmlinuz root=UUID=xxx ro single nomodeset

# 显卡问题修复
linux /boot/vmlinuz root=UUID=xxx ro nomodeset nouveau.modeset=0

# 串口控制台（服务器）
linux /boot/vmlinuz root=UUID=xxx ro console=tty0 console=ttyS0,115200n8

# 指定 init 系统
linux /boot/vmlinuz root=UUID=xxx ro systemd.unit=multi-user.target

# 设置主题目录
set theme=${prefix}/themes/mytheme/theme.txt

# 导出变量供主题使用
export theme

# 方式一：使用背景图片命令
background_image ${prefix}/themes/mytheme/background.png

# 方式二：在主题文件中配置
# 在 theme.txt 中添加：
# desktop-image: "background.png"

# 等待 5 秒后自动启动默认项
set timeout=5

# 立即启动（不显示菜单）
set timeout=0

# 需要用户手动选择（不自动启动）
set timeout=-1

# 按编号设置（0 = 第一个菜单项）
set default=0

# 按名称设置（支持通配符）
set default="Debian GNU/Linux"

# 使用上次成功启动的项（需要 grubenv）
set default=saved

# 使用 saved 时，需要以下配合
set default=saved
save_env default  # 保存当前默认项

# 默认项失败时，尝试以下备选项
set default=0
set fallback=1

# 显示菜单（即使只有一项）
set timeout_style=menu
set timeout=5

# 倒计时样式（不显示菜单，只显示倒计时）
set timeout_style=countdown
set timeout=5

# 隐藏菜单（按 Shift 键显示）
set timeout_style=hidden
set timeout=0

# 菜单颜色
set menu_color_normal=white/black       # 普通项：白字黑底
set menu_color_highlight=black/light-gray # 高亮项：黑字浅灰底

# 支持的颜色名称：
# black, blue, green, cyan, red, magenta, brown, light-gray
# dark-gray, light-blue, light-green, light-cyan, light-red
# light-magenta, yellow, white

# 加载字体
loadfont unicode

# 设置图形模式（分辨率）
set gfxmode=auto
# 或指定分辨率
set gfxmode=1920x1080
# 或多个备选
set gfxmode=1920x1080,1280x1024,auto

# 加载图形驱动模块
insmod all_video
# 或更精确地加载
insmod efi_gop     # UEFI 图形输出协议
insmod efi_uga     # UEFI 统一图形适配器
insmod video_bochs # BIOS VESA
insmod video_cirrus # BIOS Cirrus

# 切换到图形终端
terminal_output gfxterm

# 传递图形模式给内核
set gfxpayload=keep   # 保持 GRUB 的图形模式
# 或
set gfxpayload=text   # 使用文本模式

# 查看环境变量
$ sudo grub-editenv /boot/grub/grubenv list
# saved_entry=Debian GNU/Linux

# 设置环境变量
$ sudo grub-editenv /boot/grub/grubenv set default=0

# 设置为"记住上次启动项"
$ sudo grub-editenv /boot/grub/grubenv set saved_entry=0

# 重置环境变量
$ sudo grub-editenv /boot/grub/grubenv unset default

# 创建新的环境块文件
$ sudo grub-editenv /boot/grub/grubenv create

GRUB_DEFAULT=saved
GRUB_SAVEDEFAULT=true

$ sudo update-grub

# 默认启动项编号（从 0 开始）
# 或 "saved" 使用上次启动项
GRUB_DEFAULT=0

# 超时时间（秒）
GRUB_TIMEOUT=5

# 超时样式：menu / countdown / hidden
GRUB_TIMEOUT_STYLE=menu

# 分发版名称
GRUB_DISTRIBUTOR=`lsb_release -i -s 2> /dev/null || echo Debian`

# 内核命令行参数
GRUB_CMDLINE_LINUX_DEFAULT="quiet splash"

# 所有菜单项都追加的内核参数
GRUB_CMDLINE_LINUX=""

# 是否启用恢复模式菜单项
GRUB_DISABLE_RECOVERY="false"

# 是否禁用 os-prober（检测其他系统）
GRUB_DISABLE_OS_PROBER=false

# 终端类型
GRUB_TERMINAL="console"
# 可选值：console, serial, gfxterm, ofconsole

# 串口配置（配合 GRUB_TERMINAL=serial）
GRUB_SERIAL_COMMAND="serial --speed=9600 --unit=0 --word=8 --parity=no --stop=1"

# 图形模式分辨率
GRUB_GFXMODE=auto
# 示例：GRUB_GFXMODE=1920x1080

# 传递给内核的图形模式
GRUB_GFXPAYLOAD_LINUX=keep

# 菜单颜色
GRUB_COLOR_NORMAL="white/black"
GRUB_COLOR_HIGHLIGHT="black/light-gray"

# 背景图片
GRUB_BACKGROUND="/boot/grub/background.png"

# 主题
GRUB_THEME="/boot/grub/themes/mytheme/theme.txt"

# 字体
GRUB_FONT="/boot/grub/fonts/unicode.pf2"

# 是否保存上次启动项
GRUB_SAVEDEFAULT=false

# 是否禁用子菜单
GRUB_DISABLE_SUBMENU=true

# 是否生成 recovery 模式的 quiet 参数
GRUB_RECOVERY_COMMAND=""

# 初始化 ramdisk 是否使用 UUID
GRUB_INIT_TUNE=""

# 1. 编辑 /etc/default/grub
$ sudo nano /etc/default/grub

# 2. 编辑自定义菜单项（可选）
$ sudo nano /etc/grub.d/40_custom

# 3. 重新生成 grub.cfg
$ sudo update-grub        # Debian/Ubuntu
$ sudo grub2-mkconfig -o /boot/grub2/grub.cfg  # RHEL/Fedora
$ sudo grub-mkconfig -o /boot/grub/grub.cfg    # Arch Linux

# 4. 验证配置
$ grep menuentry /boot/grub/grub.cfg

# 5. 重启测试
$ sudo reboot