保持代码简单

1. 避免过度防御: 根据实际风险和后果处理边界情况,别为了假设问题堆积大量代码。 2. 在入口检查数据: 外部数据进入系统时检查格式和范围,内部尽量使用明确的数据类型与约定,避免重复检查。 3. 不要过早抽象: 只用一次、逻辑简单的代码可以就近写清

版本与验证范围

收藏整理,原作者与来源见正文;不作为 Lan 的原创项目或实测结论。

来源:用户提供的图片。图片标称整理自 OpenCode 公开仓库的 AGENTS.md,本次未核实原文。

四条建议

  1. 避免过度防御: 根据实际风险和后果处理边界情况,别为了假设问题堆积大量代码。
  2. 在入口检查数据: 外部数据进入系统时检查格式和范围,内部尽量使用明确的数据类型与约定,避免重复检查。
  3. 不要过早抽象: 只用一次、逻辑简单的代码可以就近写清楚;出现稳定的重复需求后再考虑提取公共函数。
  4. 控制复杂度: 函数拆分和异常处理都要有明确用途,让代码容易阅读、定位问题和维护。

放到我的工程里

以四足机器人为例:收到外部关节角度指令时,先检查格式、关节编号和允许范围,再交给内部控制逻辑。硬件读数、通信、任务并发和供电故障仍要按真实风险处理,不能因为追求代码短就省掉必要保护。

注意: 类型并不自动保证数据合法。像 C 语言、外设输入、跨任务共享数据和可能失败的资源操作,仍要在相应边界处理错误和状态。

来源与关联索引
来源
个人知识库
原笔记
抖音收藏待整理/005-保持代码简单.md
资料性质
工程笔记。原文的版本、来源与验证边界继续保留。
返回文章目录

想去哪里?

22 个入口

首页作品作品展厅全部项目文章总览文件夹标签资料归档关于认识 Lan探索路线工具与工作台最近在做InkFeed · 4.2 英寸电子纸信息终端VIBRATION · 柔性振动检测与采集链路TRACE · 航向保持与灰度循迹小车STRIDE · 八自由度四足机器人SCOPE · 固件日志浏览器温度为什么被 AI 改了?FIFO 有半帧,就一定是故障吗?直线守航向,弧线再看黑线。

Tab 选择入口 · Enter 打开 · Esc 关闭