| name | evolution |
| description | 仓颉开发经验总结。遇到编译错误、API 差异、迁移问题时查阅已积累的踩坑记录和解决方案 |
仓颉语言开发经验总结
开发过程中遇到非显而易见的问题并解决后,将经验记录到对应分类中。
分类说明
经验沉淀分工:
- 本目录(
evolution/cangjie/):仓颉语言 + HarmonyOS 开发中的通用经验(语法踩坑、编译配置、API 行为差异等)
cangjie-translate/*2cangjie/:应用翻译中"源语言 → 仓颉"的语法 / 表达差异
cangjie-translate-lib/experience/:库翻译独有的工程化经验(包布局、API 面、依赖替代、cjpm 构建)
两边有交叉的语法点优先记到 cangjie-translate/*2cangjie/,本目录只记与翻译无关的通用经验。
经验记录规范
何时记录
解决了一个非显而易见的问题后,将经验追加到对应分类中:
- 文档未提及或描述不清的行为
- 需要特定组合才能工作的配置
- 容易混淆的 API 或概念
- 性能陷阱或反直觉的行为
- 从其他语言迁移时的等价写法差异
文件组织
每个分类目录下有一个 README.md 作为索引,经验按主题拆分为独立文件(如 syntax.md、arkui.md)。新增经验时:
- 若属于已有主题文件,直接追加
- 若属于新主题,创建新文件并更新该目录的
README.md 索引
不预先创建空文件,遇到对应问题时再创建。
单条经验格式
## [经验标题]
**问题**: 描述遇到的现象或报错信息
**原因**: 根因分析
**解决方案**:
具体修改步骤或代码示例
**相关文档**: 指向 cangjie-kernel / cangjie-harmony 中的具体文档(如有)
记录原则
- 一条经验解决一个问题
- 先写问题现象,方便后续通过报错信息检索
- 附最小复现代码(如果与特定代码模式相关)
- 保持简洁,经验记录不是教程