更新记录

1.0.0（2026-06-15） 下载此版本

• 支持在 HBuilderX 项目文件夹右键，从 JSON 生成 UTS 模型文件。
• 支持标准 JSON 和 HBuilderX 控制台 UTSJSONObject 日志结构。
• 支持 JSON 实时校验、错误提示和格式化。
• 生成默认值函数与 UTSJSONObject 转换函数。

平台兼容性

HBuilderX插件通用注意事项

HBuilderX-2.7.12以下版本安装插件市场内的插件后，卸载时需手动卸载，详细教程参考：如何手动卸载插件

JSON 转 UTS 模型生成器

这是一个 HBuilderX 插件，用来把 JSON 数据生成 uni-app x 可用的 UTS 数据模型文件。

插件支持两种 JSON 输入：

• 标准 JSON，例如接口文档里的返回示例。
• HBuilderX 控制台打印出来的 JSON 结构，例如带有 // [UTSJSONObject]、// [number] 这类类型注释的日志。

插件信息

• 插件 id：uts-model-generator
• 插件名称：JSON 转 UTS 模型生成器
• 入口菜单：JSON 转 UTS 模型：生成模型文件
• 推荐搜索标签：utsJson JSON转模型 UTS模型 数据模型 uniappx

使用步骤

1. 在 HBuilderX 中打开需要生成模型文件的项目。
2. 在项目管理器里，右键点击要保存模型文件的文件夹。
3. 点击菜单里的 JSON 转 UTS 模型：生成模型文件。

4. 在弹窗中填写 模型 name，例如 Ceshi、LoginResult、UserInfo。
5. 把接口返回 JSON 或 HBuilderX 控制台 JSON 日志粘贴到 详细 JSON 输入框。
6. 如果 JSON 是压缩在一行里的，可以点击 格式化 JSON。
7. 当 JSON 合规时，输入框下方会显示绿色提示，并且 生成 按钮可以点击。
8. 当 JSON 不合规时，输入框会显示红框和错误提示，生成 按钮会保持不可用。

生成结果

插件会在右键选中的文件夹下生成一个 .uts 文件。

例如填写：

• 生成目录：/api
• 模型 name：Ceshi

最终会生成：

/api/Ceshi.uts

生成的文件中包含：

• export type Ceshi = { ... }
• createCeshi()：创建默认数据。
• createCeshiFromJson(json : UTSJSONObject | null)：把 uni.request 返回的 UTSJSONObject 转成 Ceshi。
• createCeshiArrayFromJson(list : Array<UTSJSONObject> | null)：把 UTSJSONObject 数组转成 Array<Ceshi>。

页面中使用

在 .uvue 页面中，不要直接把 UTSJSONObject 写成 res as Ceshi，因为运行时对象还是 UTSJSONObject，不能直接强转成自定义 type。

应该使用插件生成的转换函数：

import { createCeshi, createCeshiFromJson, type Ceshi } from '@/api/Ceshi.uts'

const loginData = ref<Ceshi>(createCeshi())

uni.request({
    url: '接口地址',
    method: 'POST',
    data: {}
}).then((res : any) => {
    const full = createCeshiFromJson(res as UTSJSONObject)
    loginData.value = full
})

开发时重新加载插件

修改插件代码或 package.json 后，HBuilderX 不会自动热更新插件。

需要在插件开发窗口中重新运行：

1. 停止当前插件运行。
2. 再次点击运行按钮，或按 Ctrl+r 重新运行。
3. 在新打开的 HBuilderX 窗口中测试右键菜单。