表结构改动后,zion-code中依赖该数据结构的页面逻辑必须同步更新,否则运行时会崩溃;需通过grep定位引用旧表名或字段的文件,重点检查GearRepository.ets、gear-list/index.ets和gear-card.vue,对SQL查询补全area字段或视图层兜底,默认值为“器材室”。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

表结构改动后,zion-code 代码库中依赖该数据结构的页面逻辑必须同步更新,否则运行时会因字段缺失、类型不匹配或查询失败直接崩溃。这不是可选项,而是数据契约变更后的强制响应。
判断哪些页面需要改
先定位所有引用旧表名或旧字段的文件:在项目根目录执行 grep -r "GEAR\|gear" src/ data/ --include="*.ts" --include="*.js" --include="*.ets",重点检查 data/GearRepository.ets、pages/gear-list/index.ets 和 components/gear-card.vue 这三类位置。
只要某处代码里出现 row.area、SELECT * FROM GEAR 或 gear.area 这类写死字段或全量查询,就必须修改——新版表已新增 GEAR.AREA 字段,默认值为“器材室”,但旧代码若未显式声明该字段,SQLite 查询将返回 undefined,导致 UI 渲染报错或空白。
页面层具体怎么改
方法一:补全字段声明(推荐)
打开 pages/gear-list/index.ets,找到数据获取逻辑,把原来的 SELECT id, name, count FROM GEAR 改成 SELECT id, name, count, area FROM GEAR。这一步不能省,【不加 area 字段会导致 this.gearList[i].area 为 undefined,后续渲染时 this.area ?? '未知区域' 仍会触发空值警告】。
方法二:适配默认值(兜底)
在 components/gear-card.vue 的模板中,把 {{ gear.area }} 替换为 {{ gear.area || '器材室' }}。注意:这只是视图层容错,不能替代 SQL 查询字段补全,否则排序、筛选、导出等逻辑仍会失效。
迁移后验证路径
第一步:确认数据库版本已升至 v2
第二步:清空旧数据缓存(执行 AppStorage.SetOrCreate('gearList', []))
第三步:重启 App,进入 gear-list 页面 → 观察控制台是否打印 [INFO] Loaded 12 gears, each with .area field
第四步:手动添加一条新器材记录 → 检查其 area 字段是否自动填入“器材室”且可被编辑

















