来源:用户提供的图片。图片标称整理自 OpenCode 公开仓库的 AGENTS.md,本次未核实原文。
四条建议
- 避免过度防御: 根据实际风险和后果处理边界情况,别为了假设问题堆积大量代码。
- 在入口检查数据: 外部数据进入系统时检查格式和范围,内部尽量使用明确的数据类型与约定,避免重复检查。
- 不要过早抽象: 只用一次、逻辑简单的代码可以就近写清楚;出现稳定的重复需求后再考虑提取公共函数。
- 控制复杂度: 函数拆分和异常处理都要有明确用途,让代码容易阅读、定位问题和维护。
放到我的工程里
以四足机器人为例:收到外部关节角度指令时,先检查格式、关节编号和允许范围,再交给内部控制逻辑。硬件读数、通信、任务并发和供电故障仍要按真实风险处理,不能因为追求代码短就省掉必要保护。
注意: 类型并不自动保证数据合法。像 C 语言、外设输入、跨任务共享数据和可能失败的资源操作,仍要在相应边界处理错误和状态。
来源与关联索引
- 来源
- 个人知识库
- 原笔记
- 抖音收藏待整理/005-保持代码简单.md
- 资料性质
- 工程笔记。原文的版本、来源与验证边界继续保留。