七、数据文件结构

37 个文件清晰的组织结构

每个子分类一个 JSON 文件，加上元数据索引和单词检索索引。按需加载，快速检索，易于维护。

分类文件

索引文件

层级目录

7.1

文件组织

每个子分类一个 JSON 文件，按层级命名。index.json 存储元数据，word-index.json 用于单词检索。

├── L1-FILE.json ← 文件与存储

├── L1-DATA.json

├── L1-NET.json

├── L1-GFX.json

├── L1-UI.json

├── L1-INPUT.json

├── L2-MAC.json

├── L2-IOS.json

├── L2-WIN.json

├── L2-LNX.json

├── L2-SET.json

├── L3-GEN.json

├── L3-HTML.json

├── L3-CSS.json

├── L3-JS.json

├── L3-SWI.json

├── L3-PY.json

├── L3-TS.json

├── L4-VSC.json

├── L4-XC.json

├── L4-AI.json

├── L4-GIT.json

├── L4-BRW.json

├── L4-OPS.json

├── L5-FIG.json

├── L5-SKT.json

├── L5-PS.json

├── L5-IL.json

├── L5-PR.json

├── L5-AE.json

├── L5-AU.json

├── L5-DOC.json

├── L5-XLS.json

├── L5-PPT.json

├── L6-VSCP.json

├── L6-FIGP.json

├── L6-BRWP.json

├── index.json ← 元数据索引

└── word-index.json ← 单词检索索引

7.2

index.json 元数据索引

存储词库的版本、更新时间、总词量，以及各层级的分类结构。前端加载时首先读取此文件，构建导航结构。

{ }index.json
{
"version": "1.0.0",
"lastUpdated": "2026-03-10",
"totalWords": 300,
"layers": [
{
"id": "L1",
"name": "计算机基础",
"nameEn": "Fundamentals",
"categories": [
{ "id": "L1-FILE", "name": "文件与存储", "count": 15 },
{ "id": "L1-UI", "name": "界面通用", "count": 20 }
]
}
]
}

字段说明

version词库版本号，语义化版本控制

lastUpdated最后更新日期，ISO 8601 格式

totalWords当前词库总词条数

layers六层架构的完整结构，包含层级ID、中英文名称、子分类列表

categories每个子分类的 ID、名称和词条数量

7.3

word-index.json 单词检索索引

解决「同一个单词出现在多个文件」的检索问题。前端搜索时只查这个索引，不需要遍历 37 个文件。

{
"frame": [
{ "id": "L1-UI-frame", "file": "L1-UI.json", "cn": "框架" },
{ "id": "L3-HTML-frame", "file": "L3-HTML.json", "cn": "内嵌框架" },
{ "id": "L5-FIG-frame", "file": "L5-FIG.json", "cn": "画框容器" },
{ "id": "L5-PR-frame", "file": "L5-PR.json", "cn": "视频帧" }
],
"merge": [
{ "id": "L4-GIT-merge", "file": "L4-GIT.json", "cn": "合并分支" },
{ "id": "L5-PS-merge", "file": "L5-PS.json", "cn": "合并图层" },
{ "id": "L5-XLS-merge", "file": "L5-XLS.json", "cn": "合并单元格" }
],
"opacity": [
{ "id": "L1-UI-opacity", "file": "L1-UI.json", "cn": "不透明度" }
]
}

生成规则

key 是单词小写（空格转连字符）

value 是该词在所有文件中的出现记录

只有一条记录的词（如 opacity）也要收录——保证搜索完整性

此文件由脚本从 37 个分类文件自动生成，不手动维护

结构清晰

进入词库，体验基于索引的高效检索

进入词库