Skip to content

导入旧 VGUS 工程

本章说明如何将旧版 VGUS(.vt)工程导入为 VGUS Next(.vtnext)工程。导入过程为 复制资源 + 转换工程文件,不会修改原始旧工程。

若你从零开始新建界面,请改读 第一次工程

前置条件

  • 已安装并可启动 VGUS Next
  • 已有可导入的旧工程 文件夹(目录内至少包含一个 .vt 文件,以及图片、字库等资源子目录)
  • 旧工程须用 VGUS2026(2026-06-01 及之后版本) 打开并保存过;更早保存版本需先升级保存后再导入

不支持的情况

  • 不能直接选择单个 .vt 文件,必须选择 工程所在文件夹
  • 不能通过本功能打开已有的 .vtnext(请用「打开工程」)
  • 不支持以 .vgp.vgus 等其他后缀作为导入源

1. 打开导入入口

启动 VGUS Next 后会先进入 欢迎页(必经入口,不能关闭)。首次导入请在欢迎页操作;若已在主界面,也可从顶部工具栏进入。

  1. 欢迎页(推荐): 点击 导入旧VGUS工程
  2. 主界面: 在窗口顶部点开 工程,在工程文件一组按钮里点 导入工程

两者打开同一对话框,窗口标题为 导入旧VGUS工程

在欢迎页点导入旧VGUS工程,或从窗口顶部导入工程打开对话框

2. 选择旧工程路径

  1. 导入工程路径 分组中,点击 浏览...,选择旧工程所在的 文件夹(不要选 .vt 文件本身)
  2. 也可手动填写该文件夹的完整路径
  3. 填写或选择后,软件会自动校验:
    • 文件夹内是否存在 .vt 文件(优先匹配「文件夹名.vt」,否则取目录中第一个 .vt
    • .vt 的保存版本是否满足最低要求(2026-06-01 及之后)

校验通过后,工程名称 会按 .vt 文件名自动填充(可再修改)。

提示

导入路径无效、找不到 .vt、或版本过旧时,对话框会提示原因。版本过旧时,请先用 VGUS2026(2026-06-01 及之后)打开该工程并保存,再重新导入。

浏览并选中含 vt 的旧工程文件夹,工程名称自动填充

3. 设置新工程存储位置

工程存储路径 分组中填写:

字段说明
工程名称新工程目录名与 .vtnext 文件名的基础名称
存储路径已存在的父目录;最终目录为「存储路径 / 工程名称」

路径要求

  • ⚠️ 存储路径必须是 已存在 的文件夹
  • ⚠️ 存储路径 不能 与导入路径相同,也 不能 位于导入路径的子目录内(避免目录嵌套)
填写或浏览选择新工程存储路径,确认存储路径与工程名称

4. 确认导入并等待转换

  1. 点击 确定
  2. 进度对话框依次显示类似状态:准备中 → 复制工程文件 → 转换 .vt.vtnext → 完成
  3. 转换成功后,软件会 自动打开 新生成的 .vtnext 工程并进入主界面(离开欢迎页)

导入过程中,软件会:

  • 将旧工程资源复制到新目录(排除旧编译产物目录)
  • 整理到统一的资源目录结构
  • 生成 <工程名>.vtnext,并清理目标目录中的 .vt 文件
  • 打开工程时尽量保留原有变量地址分配
点击确定后出现进度提示,完成后自动打开已转换的 Next 工程

预期结果

  • 在「存储路径 / 工程名称」下得到可编辑的 VGUS Next 工程(含 .vtnext 与资源)
  • 原旧工程文件夹保持不变
  • 设计区中可见旧工程转换而来的页面与控件

常见问题

  • 提示找不到 .vt / 导入路径无效: 确认选的是工程文件夹,且文件夹内确有 .vt 文件。
  • 提示版本过旧、不支持直接导入: 用 VGUS2026(2026-06-01 及之后)打开旧工程并保存,再重新导入。
  • 提示存储路径无效或路径冲突: 换一个已存在的父目录,且不要选在旧工程目录内部。
  • 导入后部分控件显示异常: 核对属性与地址;完整控件说明见 控件参考。若仍使用点阵字库并打算改矢量,见 字库 的升级一节。
  • 只想打开已有 Next 工程: 使用欢迎页 打开工程 或窗口顶部的 打开,选择 *.vtnext

相关内容