GameCSV - 游戏开发专用 CSV 编辑器

GameCSV 是一款专为游戏开发量身定制的 CSV 编辑器插件。它不仅支持标准的表格编辑功能，还提供了丰富的富文本渲染组件（如图片预览、音频试听、颜色选择器等），以及强大的结构化数据支持（数组、结构体、嵌套定义），极大提升了游戏配置表的编辑效率。

✨ 核心特性

• 丰富的数据类型：支持图片、音频、颜色、日期、布尔值等多种可视化组件。
• 结构化数据支持：完美支持数组（Array）、结构体（Struct）以及嵌套结构，告别手动拼接 JSON 字符串。
• 智能 ID 引用：支持配置表之间的 ID 关联跳转，数据关系一目了然。
• 快捷枚举与范围：支持下拉枚举（Enum）和数值范围（Range）约束，防止配置错误。
• 多表单管理：底部标签页支持快速切换和管理多个 CSV 文件（Sheet）。
• 简洁高效：基于 VS Code Webview，无缝集成，操作流畅。

📋 CSV 列定义规范

GameCSV 依赖特定的 CSV 表头格式来识别列类型。支持以下两种格式：

1. 简写格式 (推荐)

直接使用列名作为表头。此时列类型将默认为 var（自动推断）。

• 例外：如果列名为 ID（不区分大小写），且是第一列，则类型自动识别为 id。

2. 完整 JSON 格式

使用单引号包裹的 JSON 对象来定义列的详细属性。 格式：{'name':'列名', 'type':'类型', ...}

示例：

"{'name':'ID','type':'id'}", "{'name':'Name','type':'string'}", "{'name':'Icon','type':'img'}"

为了兼容旧习惯，也支持一种中间格式（不推荐）： 列名{type:类型} (注意：此格式在内部会被转换为 JSON 格式处理)

3. 类型参考

以下类型需在 type 字段中指定：

基础类型

资源与可视化

结构化类型

• 数组: type:'array[子类型]'
  • 示例: {'name':'Rewards', 'type':'array[int]'}
• 结构体: type:'struct' (需配合 struct_def 属性)
  • 示例: {'name':'Config', 'type':'struct', 'struct_def':{'MyStruct':{'p1':'int'}}}

内置快捷结构体

直接使用以下类型名称即可使用预定义的结构体：

• id_num: ID + 数量
• id_string: ID + 文本
• img_num: 图片 + 数量
• img_string: 图片 + 文本

🚀 快速开始

1. 在 VS Code 中安装本插件。
2. 创建一个 .csv 文件。
3. 输入表头，例如：ID{type:id}, Name{type:string}, Icon{type:img}, Props{type:array[id_num]}。
4. 保存文件，GameCSV 将自动识别并渲染为可视化编辑器。
5. 点击单元格右侧的图标进行编辑，或使用侧边栏编辑复杂结构。

🔗 更多

如有问题或建议，欢迎反馈！