Linux系统之grub-mklayout详解

grub-mklayout 是 GRUB 工具链中的一个实用工具，用于将 Linux 控制台的键盘布局描述文件转换为 GRUB 可识别的键盘布局描述文件。该工具允许用户自定义 GRUB 引导菜单中的键盘输入法（如 QWERTY、AZERTY、Dvorak 等），以支持多语言环境下的字符输入。

基本语法

grub-mklayout [选项]

选项说明

选项	描述
-i / --input=FILE	使用 FILE 作为输入文件（默认为标准输入）。
-o / --output=FILE	将生成的布局文件写入 FILE（默认为标准输出）。
-v / --verbose	输出详细调试信息（推荐首次使用时启用）。

使用场景与示例

1. 生成默认布局文件

sudo grub-mklayout -o /boot/grub/layouts/us_layout.lst /usr/share/kbd/keymaps/i386/qwerty/us.map.gz

• 效果：将 Linux 的 us.map.gz 键盘布局转换为 GRUB 的 us_layout.lst 文件。
• 应用场景：为英文用户生成 GRUB 引导菜单的英文键盘布局。

2. 使用标准输入和输出

cat /usr/share/kbd/keymaps/i386/fr/azerty.map.gz | sudo grub-mklayout -o /boot/grub/layouts/fr_layout.lst

• 效果：通过管道将输入文件传递给 grub-mklayout，生成法语 AZERTY 布局文件。
• 应用场景：批量生成多种语言的 GRUB 布局文件。

3. 启用调试模式

sudo grub-mklayout --verbose -i /usr/share/kbd/keymaps/i386/dvorak/dk.map.gz -o /boot/grub/layouts/dvorak_layout.lst

• 效果：输出详细转换过程，便于验证 Dvorak 布局是否正确生成。
• 应用场景：调试自定义键盘布局或排查转换错误。

注意事项

1. 输入文件格式要求

   • 输入文件需为 Linux 控制台的 .map.gz 格式（如 /usr/share/kbd/keymaps/ 目录下的文件）。
   • 示例文件路径：

     /usr/share/kbd/keymaps/i386/qwerty/us.map.gz
     /usr/share/kbd/keymaps/i386/fr/azerty.map.gz
     

2. 输出路径权限

   • 生成的布局文件需保存在 GRUB 可访问的目录（如 /boot/grub/layouts/）。
   • 示例权限设置：

     sudo chmod 644 /boot/grub/layouts/us_layout.lst
     

3. GRUB 配置集成

   • 生成的布局文件需通过 GRUB 配置文件（grub.cfg）加载。
   • 示例 GRUB 配置：

     set keyboard_layout=us
     loadkbd /boot/grub/layouts/us_layout.lst
     

   • 执行 grub-mkconfig -o /boot/grub/grub.cfg 更新配置。

4. 布局文件命名规范

   • 推荐使用语言代码命名布局文件（如 en.lst、fr.lst），以便管理多语言环境。
   • 示例命名：

     /boot/grub/layouts/en.lst
     /boot/grub/layouts/es.lst
     

5. 布局兼容性

   • 并非所有 Linux 键盘布局都能完美转换为 GRUB 格式，需测试实际效果。
   • 若布局未生效，可尝试更新 GRUB 配置或检查 .lst 文件内容。

典型工作流程

1. 选择 Linux 键盘布局

   • 从 /usr/share/kbd/keymaps/ 目录中选择所需布局文件（如 us.map.gz）。

2. 生成 GRUB 布局文件

   sudo grub-mklayout -i <输入文件> -o <输出路径>
   

3. 备份并替换原布局文件

   sudo cp /boot/grub/layouts/en.lst /boot/grub/layouts/en.lst.bak
   sudo mv <输出路径> /boot/grub/layouts/en.lst
   

4. 更新 GRUB 配置

   sudo grub-mkconfig -o /boot/grub/grub.cfg
   

5. 重启测试

   • 重启系统并进入 GRUB 菜单，验证键盘布局是否生效。

常见问题与解决方案

1. 错误提示：grub-mklayout: error: no input file specified

• 原因：未指定输入文件路径。
• 解决方法：
  • 确认命令包含 --input 或 -i 参数，且路径正确（如 /usr/share/kbd/keymaps/...）。

2. 错误提示：grub-mklayout: error: invalid input file format

• 原因：输入文件不是有效的 .map.gz 格式。
• 解决方法：
  • 确认输入文件为 Linux 控制台的 .map.gz 文件。
  • 使用 zcat 验证文件内容：

    zcat <输入文件> | head -n 10
    

3. 错误提示：grub-mklayout: error: cannot write to output file

• 原因：输出路径无写入权限。
• 解决方法：
  • 使用 sudo 运行命令，或手动更改输出路径权限：

    sudo chmod 755 /boot/grub/layouts/
    

4. GRUB 菜单键盘布局未生效

• 原因：未正确加载新布局文件。
• 解决方法：
  • 检查 grub.cfg 中的 loadkbd 路径是否正确。
  • 确保 grub-mkconfig 已执行。