如何创建ventoy.json文件

如何创建Ventoy.json文件：打造个性化启动盘配置指南

Ventoy作为一款开源的多系统启动工具，凭借其“一次写入，多系统启动”的特性，深受技术爱好者青睐，而ventoy.json文件则是Ventoy的“灵魂配置文件”，通过它用户可以自定义启动盘的行为，比如默认启动项、界面样式、设备过滤规则等，让启动盘更贴合个人使用习惯，本文将详细介绍如何创建和配置ventoy.json文件,帮助你轻松打造专属的个性化启动盘。

什么是ventoy.json文件？为什么需要它？

ventoy.json是Ventoy的配置文件，用于存储用户对启动盘的自定义设置，它以JSON格式存储，通常放置在Ventoy启动盘的根目录下（与Ventoy2Disk.exe同级），当Ventoy启动时，会自动读取该文件中的配置,并按照预设规则执行操作。

相比手动通过Ventoy图形界面调整，ventoy.json的优势在于：

配置可复用：制作多张启动盘时，可直接复制ventoy.json文件，无需重复设置；
功能更丰富：支持界面隐藏、设备过滤、默认启动项等高级功能，部分功能在图形界面中无法直接配置；
自动化友好：可通过脚本批量生成配置,适合批量部署场景。

创建ventoy.json文件的准备工作

在创建ventoy.json文件前，需确保以下条件就绪：

Ventoy已安装：已通过Ventoy2Disk.exe将Ventoy写入U盘或移动硬盘（此时U盘会自动生成Ventoy分区，文件系统为FAT32或exFAT）；
文本编辑器：准备支持JSON格式的文本编辑器，如Windows记事本（需另存为UTF-8编码）、Notepad++、VS Code，或Linux下的Vim、Nano等；
了解JSON基础：JSON格式要求严格，需注意键值对的格式（键用双引号包裹，值根据类型用双引号、数字、布尔值等表示）,且不能有多余的逗号或括号。

创建ventoy.json文件的详细步骤

步骤1：定位Ventoy分区

插入制作好的Ventoy启动盘，在文件资源管理器中找到名为“Ventoy”的分区（通常为FAT32格式），这就是存放ventoy.json文件的位置。

步骤2：新建文本文档

在Ventoy分区的根目录下，右键点击空白处，选择“新建”→“文本文档”，创建一个名为“新建文本文档.txt”的文件（文件名可自定义，后续需修改扩展名）。

步骤3：编写JSON配置内容

双击打开新建的文本文档，根据需求编写JSON配置，以下是基础配置示例，可根据后续功能需求逐步扩展：

{
    "control": [
        { "VTOY_DEFAULT_MENU_ENTRY": "0" },
        { "VTOY_DEFAULT_ITEM": "Windows 11 PE" },
        { "VTOY_MENU_SHOW_MODIFY": false },
        { "VTOY_THEME": "ventoy_bg.jpg" }
    ]
}

步骤4：保存为UTF-8编码并修改文件名

保存编码：点击“文件”→“另存为”，在“编码”下拉菜单中选择“UTF-8”（避免中文或特殊字符乱码），保存文件；
修改文件名：回到Ventoy分区，将文件名从“新建文本文档.txt”重命名为ventoy.json（注意扩展名从.txt改为.json，若系统隐藏扩展名，需在“文件资源管理器”→“查看”中勾选“文件扩展名”）。

ventoy.json常用配置项解析

ventoy.json的核心配置位于control数组中，每个对象代表一个配置项，键为配置名，值为对应参数,以下是常用配置项及说明：

默认启动项控制

VTOY_DEFAULT_MENU_ENTRY：指定默认菜单项的索引（从0开始），"0"表示第一个菜单项，"1"表示第二个，以此类推。
示例：{ "VTOY_DEFAULT_MENU_ENTRY": "0" }（默认启动第一个系统）。
VTOY_DEFAULT_ITEM：通过菜单项名称指定默认启动项（优先级高于索引，若名称匹配则忽略索引）。
示例：{ "VTOY_DEFAULT_ITEM": "Windows 11 PE" }（直接匹配名称为“Windows 11 PE”的启动项）。

界面与菜单设置

VTOY_MENU_SHOW_MODIFY：是否显示菜单修改选项（如添加、删除启动项）。true显示，false隐藏。
示例：{ "VTOY_MENU_SHOW_MODIFY": false }（隐藏菜单修改按钮，避免误操作）。
VTOY_THEME：指定启动界面的背景图片，需将图片文件（如ventoy_bg.jpg）放在Ventoy分区根目录。
示例：{ "VTOY_THEME": "ventoy_bg.jpg" }（使用分区根目录的ventoy_bg.jpg作为背景）。
VTOY_MENU_TIMEOUT：菜单超时时间（单位：秒），超时后自动启动默认项，若设为-1，则不超时（需手动选择）。
示例：{ "VTOY_MENU_TIMEOUT": 10 }（10秒后自动启动默认项）。

设备与文件过滤

VTOY_ENABLE_BIOS_BOOT：是否在BIOS模式下显示启动菜单。true显示，false隐藏（仅UEFI模式可用）。
示例：{ "VTOY_ENABLE_BIOS_BOOT": false }（BIOS模式下不显示Ventoy菜单）。
VTOY_FILTER_SUPPORTED_OS：是否过滤不支持的操作系统（如32位系统在64位Ventoy下会被过滤）。true过滤，false显示全部。
示例：{ "VTOY_FILTER_SUPPORTED_OS": true }（仅显示支持的系统）。

高级功能

VTOY_GRUB_TIMEOUT：Grub引导菜单超时时间（单位：秒），仅在使用Grub作为引导器时生效（如某些Linux系统）。
示例：{ "VTOY_GRUB_TIMEOUT": 5 }（Grub菜单5秒后自动启动）。
VTOY_SECURE_BOOT：是否强制启用Secure Boot（仅影响Ventoy自身引导，不影响系统）。true强制启用，false不强制。
示例：{ "VTOY_SECURE_BOOT": false }（不强制Secure Boot，方便引导未签名的系统）。

配置验证与常见问题

验证配置是否生效

保存ventoy.json文件后，重启电脑并从Ventoy启动盘启动，观察以下现象验证配置：

默认启动项是否按预期自动启动；
背景图片、菜单显示/隐藏是否符合设置；
超时时间是否生效。

常见问题及解决

问题1：启动后无任何配置生效
原因：文件名错误（如扩展名未改为.json）、JSON格式错误（如缺少逗号、引号不匹配）。
解决：检查文件名是否为ventoy.json，使用JSON在线工具（如JSONLint）验证格式是否正确。
问题2：中文乱码
原因：保存时未使用UTF-8编码。
解决：重新用UTF-8编码保存文件（VS Code中可通过“文件”→“保存时编码”设置）。
问题3：背景图片不显示
原因：图片文件未放在Ventoy分区根目录，或图片名称与ventoy.json中的VTOY_THEME值不一致。
解决：将图片文件复制到Ventoy分区根目录，确保VTOY_THEME的值与图片文件名完全一致（含扩展名）。

进阶配置示例

以下是一个综合了多个配置的ventoy.json示例，适合需要隐藏菜单、设置背景图并自动启动的场景：

{
    "control": [
        { "VTOY_DEFAULT_MENU_ENTRY": "1" },
        { "VTOY_DEFAULT_ITEM": "Ubuntu 22.04 LTS" },
        { "VTOY_MENU_SHOW_MODIFY": false },
        { "VTOY_MENU_TIMEOUT": 8 },
        { "VTOY_THEME": "ubuntu_bg.jpg" },
        { "VTOY_ENABLE_BIOS_BOOT": false },

正文

如何创建ventoy.json文件