早上起来给一台服务器升级内核完事之后照例要跑一遍sudo update-grub刷新引导配置结果终端直接给我甩了一行红字Sourcing file /etc/default/grub /usr/sbin/grub-mkconfig: 1: /etc/default/grub: 2#: not found然后整个更新流程当场卡死/boot/grub/grub.cfg根本没动。我盯着这行报错愣了几秒第一反应是配置文件写坏了。这个报错翻译成人话就是grub-mkconfig在读取/etc/default/grub这个文件的时候发现第一行有个叫2#的东西当成命令去执行结果系统里没有这个命令直接报 not found。如果你也是改过/etc/default/grub之后遇到这条消息别慌问题基本就出在这个文件本身而且通常改掉那一行坏内容就能解决。这篇文章从这行报错的真实含义讲起逐步拆解排查思路给出一套完整的修复流程最后再分享几个我实际处理过的案例和一些预防经验适合运维人员、自己折腾 VPS 的 Linux 用户参考。1. 先搞懂 grub-mkconfig 到底在报什么错1.1/etc/default/grub只是草稿grub.cfg才是成品很多 Linux 新手容易把 GRUB 配置这件事理解成改一个文件就完事了但实际上它分好几层。你在系统里看到的/etc/default/grub并不是 GRUB 启动时真正读取的配置它只是一个供人编辑的源文件或者叫草稿。真正在开机时被 GRUB 加载的是/boot/grub/grub.cfg。这个文件由grub-mkconfig根据/etc/default/grub以及/etc/grub.d/目录下的模板脚本自动生成。sudo update-grub本质上就是一条封装命令它调用的是grub-mkconfig -o /boot/grub/grub.cfg。打个比方/etc/default/grub是源代码grub-mkconfig是编译器grub.cfg是编译出来的可执行文件。你每次手工修改草图之后必须重新编译一次改动才会进入真正生效的产物里。所以一旦源文件出问题编译就过不了整个流程就会卡在开头。1.2 把这行报错逐字段拆开看我们把这行报错拆开分析/usr/sbin/grub-mkconfig: 1: /etc/default/grub: 2#: not found/usr/sbin/grub-mkconfig:是当前报错的程序名。1:是行号表示出错位置在/etc/default/grub文件的第 1 行。/etc/default/grub:是出错的文件名。2#: not found是具体原因shell 把2#当成一条命令去执行结果命令不存在。这里要注意grub-mkconfig自己是不会去解析这个文件的它把/etc/default/grub当成一段 shell 脚本用/bin/sh去加载。Debian 和 Ubuntu 的/bin/sh通常指向 dash这是一个轻量级的 shell 实现报错风格就是这个样子跟 bash 的报错略有区别。Sourcing file \/etc/default/grub这一行是grub-mkconfig在真正开始加载前打印的提示信息。它本身不是错误只是一个我正在加载这个文件的日志。紧接着的报错才是关键。所以整个流程是grub-mkconfig启动 - 尝试加载/etc/default/grub - 加载失败 - 终止退出。为什么默认行号显示的是1而不是其他数字因为报错时 dash 对 source 进来的文件从 1 开始计数。如果你的问题出在第 3 行这里就会显示3:。这个数字非常关键直接指示你去文件的哪一行找问题。2. 根因排查为什么配置文件里会混进2#2.1/etc/default/grub本质上是一段 Shell 脚本要理解2#: not found必须先明白一个容易忽略的底层事实/etc/default/grub文件在被加载时是被当成 shell 脚本逐行解释执行的。shell 逐行处理这个文件时会遇到下面几种情况如果一行的第一个非空白字符是#整行是注释直接忽略。如果一行的格式是KEYVALUE那是一个变量赋值语句比如GRUB_TIMEOUT5。如果一行开头是某个单词后面跟参数shell 会认为你要执行一条命令。问题就出在第三种情况。变量名是有规则的在 shell 里变量名不能以数字开头。所以当 shell 遇到2# GRUB_DEFAULT0这一行时它先看到2发现这不是合法赋值因为关键字不能以数字开头再往后看#但#前面已经有字符了所以#不被当作注释起始符。于是 shell 把2#当作一个命令名试图去 PATH 路径下找这个命令找不到就报2#: not found。这里面有个非常容易迷惑的细节很多人以为只要包含#就是注释其实 shell 里注释符号必须是行首或空白字符后的第一个字符。一旦#前面连着别的字符它就是一个普通字符不再是注释符。2.2 2# 是怎么混进配置文件里的从我的经验来看2# 这类内容混进/etc/default/grub通常有三个来源都挺现实。第一种手滑误输入。用 vim 编辑文件时想在某个配置前面加上#注释结果光标没有移到行首或者按I进入插入模式时多按了数字键行首就多出一个2#。这种情况在深夜加班、精神恍惚的时候尤其容易发生。第二种复制粘贴带行号的内容。很多技术博客在贴配置示例时会带上行号比如1 GRUB_DEFAULT0 2 GRUB_TIMEOUT5如果你直接从网页复制连行号带内容一起粘进了终端编辑器里第一行就变成了1 GRUB_DEFAULT0第二行变成了2 GRUB_TIMEOUT5。正常情况下行号后面的空格还能救一命因为1会被当成命令然后报1: not found但如果行号后面恰好没有空格甚至混入了#就会变成2#这种畸形 token。第三种第三方工具写坏了文件。有些 GRUB 美化工具、启动项管理脚本会直接修改/etc/default/grub。工具本身如果对文件格式处理不当可能在文件头部或中间插入一些奇怪的内容。我见过一次某款引导管理工具在备份旧配置时把时间戳写成了2# 2024-03-15这样的注释格式直接导致后续所有update-grub操作失败。无论哪种来源只要你看到2#: not found这个报错第一反应就应该是/etc/default/grub文件里存在开头为数字的畸形内容。2.3 三条命令快速锁定问题行排查不必靠肉眼硬看直接用命令行工具效率高得多。先看文件内容和行号sudo cat -n /etc/default/grubcat -n会显示每一行的行号你直接看第 1 行或者其他报错指出的行号是不是有问题。我处理过的案例里坏行往往长这样1 2# GRUB_DEFAULT0 2 GRUB_TIMEOUT5 3 GRUB_CMDLINE_LINUX_DEFAULTquiet splash第 1 行的2#就是罪魁祸首。再看隐藏字符sudo cat -A /etc/default/grubcat -A可以显示出普通cat看不到的隐藏字符。行尾会用$标记Windows 换行符显示为^M$Tab 显示为^I。如果你发现每行结尾都有^M说明这个文件被 Windows 的记事本或某些跨平台编辑器处理过换行符被改成了 CRLF这也可能导致各种奇怪的解析问题。最后做一次 shell 语法检查sudo sh -n /etc/default/grubsh -n是只做语法检查、不实际执行的模式。如果文件有语法错误它会直接告诉你哪个命令找不到如果语法没问题则不会输出任何内容。这个命令在update-grub报错之前就能帮你预判问题非常实用。另外顺便看一眼同目录下有没有别的配置文件ls -la /etc/default/grub.d/有些发行版或工具会把额外配置放在/etc/default/grub.d/目录下这些.cfg文件同样会被grub-mkconfig加载。报错信息里明确的文件是/etc/default/grub但如果你集成过 GRUB 定制工具也要检查一下子目录里的文件。3. 修复实操从备份到重新生成启动配置3.1 第一步永远是备份不管你对这个文件多熟悉动手之前必须备份。/etc/default/grub虽然只是个配置文件但一旦改错轻则 GRUB 菜单消失重则系统开机直接进不了系统。备份命令很简单sudo cp /etc/default/grub /etc/default/grub.bak我习惯把备份文件名加上日期sudo cp /etc/default/grub /etc/default/grub.bak.$(date %Y%m%d)这样以后回溯的时候能清楚地知道这份备份是哪天留下的。记住永远不要假设自己不会手滑。我处理过太多因为就改一行导致进不去系统的案例备份这一步宁可多按一次回车也不要省略。3.2 直接修正出问题的行打开文件sudo vim /etc/default/grub如果你是 vim 新手可以用 nanosudo nano /etc/default/grub把报错指出的那一行修正。比如第 1 行是2# GRUB_DEFAULT0就改成GRUB_DEFAULT0。如果那一行的内容你根本不需要直接删掉整行也行。修正以后文件内容应该是一个干净、合法的配置。我提供一个经过验证的模板按需调整即可GRUB_DEFAULT0 GRUB_TIMEOUT5 GRUB_CMDLINE_LINUX_DEFAULTquiet splash GRUB_CMDLINE_LINUX几个关键变量的含义说一下GRUB_DEFAULT0表示默认启动第一个菜单项改成数字可以指定其他项。GRUB_TIMEOUT5是 GRUB 菜单等待时间单位是秒。GRUB_CMDLINE_LINUX_DEFAULT是默认内核启动参数quiet splash表示不打印内核日志、显示开机 logo。GRUB_CMDLINE_LINUX是所有内核条目共用的参数一般保持为空字符串即可。如果你之前启用了双系统探测可以加上GRUB_DISABLE_OS_PROBERfalse如果不想看到恢复模式菜单可以加GRUB_DISABLE_RECOVERYtrue改完之后建议先用语法检查命令验证sudo sh -n /etc/default/grub没输出就是好事说明语法没问题。3.3 如果文件已经稀烂直接重置为默认配置如果打开文件发现里面早就被人改得不成样子或者你根本不清楚自己要哪些配置最简单粗暴的方案是重置。先把坏文件移走sudo mv /etc/default/grub /etc/default/grub.broken然后用配置工具重新生成sudo dpkg-reconfigure grub-pc这个命令会弹出一个交互式界面你可以重新选择 GRUB 的安装位置、默认启动项等。配置完成后它会在合适的位置重新生成一份干净的/etc/default/grub。这里必须提醒一个坑dpkg-reconfigure grub-pc在最后阶段也会调用update-grub来重新生成grub.cfg。如果你没有把坏文件移走它同样会在加载阶段报错等于白跑一趟。所以一定要先处理掉坏文件再执行这个重配命令。RHEL、CentOS 系的发行版用grub2-mkconfig命令结构类似对应关系是update-grub的替代品。Debian/Ubuntu 系直接认准update-grub就行。3.4 重新生成 grub.cfg 并验证文件修好之后重新生成真正的引导配置sudo update-grub如果一切正常你应该会看到类似这样的输出Generating grub configuration file ... Found linux image: /boot/vmlinuz-6.5.0-44-generic Found initrd image: /boot/initrd.img-6.5.0-44-generic done这表示grub-mkconfig成功加载了干净的/etc/default/grub接着扫描了/boot目录下的内核镜像并重新生成了/boot/grub/grub.cfg。如果你想确认产物确实更新了可以看一下文件的修改时间ls -l /boot/grub/grub.cfg如果时间戳是刚才说明生成成功。我一般还会顺手检查一下引导配置里有没有包含刚才设置的参数grep -n quiet splash /boot/grub/grub.cfg | head -5看到有输出就可以放心了。4. 常见问题与排查技巧实录4.1 问题速查表我把这类问题整理成一张速查表方便你遇到类似情况快速对照症状可能原因处理方法2#: not found文件行首有数字后接注释符cat -n查看删掉或修正坏行报错行号是3:或更大数字问题在文件对应行直接跳到该行检查每行结尾有^MWindows 换行符 CRLFsed -i s/\r$// /etc/default/grub文件开头有不可见乱码UTF-8 BOMsed -i 1s/^\xef\xbb\xbf// /etc/default/grubsh -n报其他 not found文件里混入了命令重写或重置默认配置update-grub 成功但重启无效UEFI 下产物路径不一致检查/boot/efi/EFI下的引导文件4.2 我处理过的几个真实案例第一个案例生产服务器上出现过一次2#: not found。排查发现运维同事用某款 Windows 下的文本编辑器改完文件从 git 提交历史里看到文件变成了 CRLF 换行而且第一行被他误改成了2# GRUB_DEFAULT0。当时的处理是用sed清除^M再把错误行修正重新update-grub问题解决。第二个案例报错信息里写的是/etc/default/grub但怎么改都报错。后来用cat -A检查才发现文件第二行隐藏了一个肉眼几乎看不出来的零宽字符这个字符让整行解析失败。处理方式是直接重写整个文件而不是去删那个隐藏字符。这也是为什么我建议如果文件比较长且复杂与其纠结修某一行不如直接用干净模板重写一遍反正 GRUB 的配置项就那么多。第三个案例一台 UEFI 引导的机器update-grub明明执行成功、没有任何报错但重启后界面还是老样子。后来排查发现这台机器的 EFI 分区里有一个单独的grub.cfg它只是跳转到/boot/grub/grub.cfg但跳转路径写错了。这种情况不属于本次报错的直接范围但如果你在修复后重启发现没生效值得检查一下 EFI 相关的路径配置。4.3 预防建议让/etc/default/grub少出幺蛾子处理过几次这类问题之后我给自己定了几条规矩分享出来。第一编辑/etc/default/grub只使用 Linux 系统内的编辑器比如 vim、nano。尽量不用 Windows 记事本、或者会自动转换换行符的跨平台编辑器。如果非要用保存后第一时间用cat -A检查一遍。第二不要直接从网页复制带行号的配置。如果复制的文本里带着行号粘贴后先在本地检查一遍把行号全部去掉。第三改完配置马上验证。sudo sh -n /etc/default/grub sudo update-grub一条命令做完语法检查和配置更新速度快出问题也能立刻发现。我现在的习惯是把这个流程固化下来减少人为遗漏。第四重要服务器上我会把/etc/default/grub纳入备份体系用 etckeeper 之类的工具做版本管理。这样就算哪天文件被改坏也能通过版本历史直接git diff看出改动恢复也就是一条命令的事。最后再分享一个排查技巧如果你怀疑某个配置文件有问题但又不想直接跑update-grub影响当前系统可以加一个参数让 grub-mkconfig 输出到临时文件先看看结果再说sudo grub-mkconfig -o /tmp/grub.cfg.test生成