Excel 配表规则

框架支持 Excel 中填写所有 C# 常见基础类型：

支持多种 Excel 时间格式：

注意：
系统会自动清洗换行、中文符号、全角符号。

支持 Unity 常用的结构类型：

{
  "m00": 1, "m01": 0, "m02": 0, "m03": 0,
  "m10": 0, "m11": 1, "m12": 0, "m13": 0,
  "m20": 0, "m21": 0, "m22": 1, "m23": 0,
  "m30": 0, "m31": 0, "m32": 0, "m33": 1
}

说明：

• 系统会自动清洗所有空格、中文逗号等
• Color 支持 0~1 格式与 Hex 格式
• Matrix4x4 必须按照json格式填写

数组与 List 写法完全一致，区别在于字段类型不同。理论上支持以上所有类型的数组与列表。
下方以几个常用类型进行举例。

数组示例

List 示例

分隔符规则

• 简单数组使用逗号分隔即可
• 多结构体（如Vector）数组单条数据用括号包裹，多条用逗号分隔
• 其余复杂类型如嵌套类自定义类等均使用标准Json格式
• Excel 单元格不能换行
• 系统会自动清洗所有空格、中文逗号等

支持任意键值对结构，包括基础类型、Unity常用类型、自定义类和嵌套多层类等。
以下对每种情况举几个典型示例。

基础键值对示例：Dictionary<string,int>

{
  "speed": 100,
  "attack": 50
}

多结构字典：Dictionary<string,Vector3>

{
  "pos1": { "x": 1, "y": 2, "z": 3 },
  "pos2": { "x": 2, "y": 1, "z": 0 }
}

基础数组字典：Dictionary<string,int[]>

{
  "enemy1": [1, 2, 3],
  "enemy2": [4, 5, 6]
}

分隔符规则

• 字典类型均建议使用标准Json格式
• 系统会自动清洗所有空格、中文逗号等。

表格中允许填写自定义的数据结构类，但数据只能通过Json形式进行存储。

自定义数据类定义示例：

class DropItem {
    int id;
    int count;
}

表格中自定义数据类型示例：DropItem

{ 
  id:1001, 
  count:3 
}

自定义结构体数组：List<DropItem>/DropItem[]

[
  { id:1,count:2 },
  { id:3,count:5 }
]

字典示例：Dictionary<string, DropItem>

{
  rewardA:{ id:1001, count:2 },
  rewardB:{ id:1002, count:5 }
}

所有结构体字段会按照字段类型继续递归解析。

框架完全支持任意层级的嵌套组合结构。 这里我们以一个统一的自定义结构体作为示例：

示例数据类

class DropInfoData {
    int id;
    int value;
}

基于此结构，你可以在 Excel 中填写任意层级的嵌套 JSON，框架能够完全解析。例如：

字典嵌套结构体：Dictionary<string, DropInfoData>

{
  "drop": { "id": 1, "value": 5 }
}

数组中包含结构体：DropInfoData[]

[
  { "id": 1, "value": 2 },
  { "id": 3, "value": 4 }
]

字典嵌套字典 + 数组：Dictionary<string, Dictionary<string, DropInfoData[]>>

{
  "outer": {
    "floor1": {
      "drops": [
        { "id": 1, "value": 2 },
        { "id": 2, "value": 3 }
      ]
    },
    "floor2": {
      "drops": [
        { "id": 5, "value": 9 }
      ]
    }
  }
}

这些都会在生成类与解析阶段被完整处理。