如何创建ventoy.json文件

如何创建ventoy.json文件：详细指南与实用技巧

在使用Ventoy制作多系统启动U盘时,ventoy.json文件是一个核心配置工具，它允许用户自定义U盘的启动行为、菜单样式、设备显示等，让多系统启动更灵活、更符合个人需求，本文将详细介绍ventoy.json文件的作用、创建步骤、常用配置项及注意事项，帮助你轻松这一实用技能。

什么是ventoy.json文件？

ventoy.json是Ventoy的全局配置文件，存储在U盘的/ventoy目录下（需手动创建），当Ventoy启动时，会自动读取该文件中的配置，并据此调整启动菜单的显示和功能，与通过Ventoy GUI界面进行的临时设置不同，ventoy.json的配置是持久化的，即使更换电脑或重插U盘也不会丢失。

通过这个文件,你可以实现：

隐藏/显示特定设备（如内置硬盘、U盘）；
自定义启动菜单的标题、排序、背景图；
默认启动指定系统；
启用/禁用安全启动、BIOS模式等选项；
为不同系统添加自定义参数。

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

准备工作：确保U盘已用Ventoy格式化

在创建ventoy.json之前，你的U盘必须已通过Ventoy GUI工具格式化（格式化时会自动创建/ventoy目录），如果未格式化，请先完成以下操作：

下载并打开Ventoy GUI（Windows/Linux/Mac均有版本）；
插入U盘,选择“安装”按钮格式化U盘（注意：格式化会清空U盘所有数据，请提前备份！）。

定位ventoy目录

格式化完成后,U盘会生成一个名为ventoy的隐藏目录（部分系统可能需勾选“显示隐藏文件”才能查看）。ventoy.json文件需创建在该目录下，路径为：

U盘盘符:/ventoy/ventoy.json

创建并编辑ventoy.json文件

方法1：手动创建（推荐普通用户）

Windows系统：
在U盘/ventoy目录下，右键点击空白处 → “新建” → “文本文档”，将文件命名为ventoy.json（注意后缀必须是.json，不是.txt）。
右键点击ventoy.json → “打开方式” → “记事本”（或更专业的编辑器如VS Code、Sublime Text）。
macOS/Linux系统：
打开终端，进入U盘ventoy目录（如/Volumes/VENTOY/ventoy），执行命令创建文件：
```
touch ventoy.json
```
然后使用文本编辑器打开,
```
nano ventoy.json  # 或 vim ventoy.json
```

方法2：复制官方模板（适合需要复杂配置的用户）

Ventoy官方提供了ventoy.json的模板文件，位于Ventoy工具包的document目录下（文件名：ventoy.json.sample），你可以：

从官方GitHub仓库下载ventoy.json.sample；
复制该文件到U盘的/ventoy目录，并重命名为ventoy.json；
根据需求修改模板内容。

编辑文件内容（JSON格式规范）

ventoy.json是JSON格式的文件，必须严格遵守语法规则：

键和值用英文冒号分隔；
每组配置项用英文逗号分隔（最后一项不加逗号）；
字符串值必须用双引号包围；
大括号和方括号[]需成对出现，层次分明。

示例：一个简单的`ventoy.json`文件

{
    "control": [
        {
            "VTOY_DEFAULT_MENU_MODE": "1",
            "VTOY_DEFAULT_ITEM": "1/1",
            "VTOY_ENABLE_BIOS_USB_KEY": "1",
            "VTOY_HIDE_ALL_USB": "0"
        }
    ],
    "theme": [
        {
            "VTOY_MENU_TITLE": "My Boot Menu",
            "VTOY_MENU_BG_IMG": "/bg.jpg",
            "VTOY_MENU_FONT_SIZE": "18"
        }
    ],
    "device": [
        {
            "VTOY_DEV_NAME": "WD My Passport",
            "VTOY_HIDE_MENU": "1"
        }
    ]
}

ventoy.json常用配置项解析

控制类配置（`control`字段）

用于调整Ventoy的核心启动行为,常见选项如下：

配置项	作用	取值范围
`VTOY_DEFAULT_MENU_MODE`	启动菜单显示模式	`0`：列表模式（默认）；`1`：图形模式；`2`：列表+图形混合模式
`VTOY_DEFAULT_ITEM`	默认启动的菜单项	格式为`[菜单索引]/[设备索引]`，如`"1/1"`表示第一个菜单项的第一个设备（需通过`VTOY_MENU_ITEMS`自定义排序）
`VTOY_ENABLE_BIOS_USB_KEY`	启用BIOS USB Key功能	`0`：禁用；`1`：启用（允许通过BIOS直接指定U盘启动）
`VTOY_HIDE_ALL_USB`	隐藏所有USB设备（除Ventoy U盘）	`0`：显示；`1`：隐藏（避免误选其他U盘）
`VTOY_SAFE_PASSWORD`	设置启动菜单密码	值为密码字符串（如`"123456"`），启动时需输入密码才能进入菜单

主题类配置（`theme`字段）

用于自定义启动菜单的外观,需提前准备素材（如背景图、字体文件）并存放在U盘根目录或指定路径：

配置项	作用	示例
`VTOY_MENU_TITLE`	`"My Multi-Boot USB"`
`VTOY_MENU_BG_IMG`	菜单背景图路径	`"/bg.jpg"`（图片需存放在U盘根目录）
`VTOY_MENU_FONT_SIZE`	菜单字体大小	`"16"`（像素，建议12-24）
`VTOY_MENU_FONT_COLOR`	菜单字体颜色	`"#FFFFFF"`（白色，支持十六进制颜色码）
`VTOY_MENU_SEL_COLOR`	选中项字体颜色	`"#FF0000"`（红色）

设备类配置（`device`字段）

用于控制特定设备的显示和启动行为,需通过VTOY_DEV_NAME或VTOY_DEV_UUID标识设备：

配置项	作用	示例
`VTOY_DEV_NAME`	设备名称（需与Ventoy识别的名称一致）	`"Kingston DataTraveler 100"`
`VTOY_HIDE_MENU`	隐藏指定设备的菜单项	`0`：显示；`1`：隐藏（如隐藏内置硬盘，避免误装系统）
`VTOY_DEFAULT_ITEM_FOR_DEV`	指定设备的默认启动项	格式为`[菜单索引]`，如`"2"`表示该设备第二个菜单项默认启动

注意事项与常见问题

JSON语法错误排查

如果ventoy.json语法错误（如缺少逗号、引号不匹配），Ventoy可能无法识别配置，导致启动菜单异常，建议使用在线JSON格式化工具（如JSONLint）检查语法是否正确。

设备名称获取方法

VTOY_DEV_NAME需与Ventoy识别的设备名称完全一致（含空格和大小写），查看设备名称的方法：

在Ventoy启动菜单中,将光标移动到目标设备，屏幕底部会显示设备名称；
或通过diskutil info /dev/diskX（macOS）/dev/sdX（Linux）命令查询。

配置文件生效方式

新创建/修改文件后：需重新插拔U盘，或通过Ventoy GUI的“Update”按钮更新配置；
已启动系统后修改：需重启电脑并重新进入Ventoy菜单才会生效。

备份配置文件

ventoy.json丢失会导致自定义配置失效，建议定期备份该文件（可复制一份到电脑硬盘）。

正文

如何创建ventoy.json文件