写文档的时候，加个注释挺常见的。比如在代码里标一句‘这里临时绕过验证’，或者在排版文档里写‘图片待替换’。可问题是，这些注释真的会有人回头去看、去改吗？
注释不是设了就完事
很多人觉得，只要把问题标注出来，任务就算完成了。但现实是，几个月后项目重启，新同事打开文件，看到一行‘此处逻辑有问题，后续修复’，却完全不知道‘后续’到底有没有来。更尴尬的是，那行问题其实早就修好了，注释却还挂着，反而让人不敢动。
时间一长，注释变“谣言”
有个朋友在整理旧项目时发现，一份文档里写着‘接口返回格式不稳定，请勿依赖字段顺序’。结果他一查最新接口文档，人家早就规范了 JSON 输出。这个注释原本是对的，可三年没更新，反倒误导了新人以为系统很不靠谱。
这就像你搬家前在门上贴了张纸条‘钥匙在花盆下’，搬走之后也没撕掉。新住户照做，结果当然找不到。
代码里的注释更得勤快点
看这段代码：
// TODO: 支持多语言，目前只显示中文
if (lang === 'zh') {
showMenu();
}如果项目早就加上英文、日文支持了，但没人删这行注释，后来的人一看，还以为多语言功能没做，白白浪费时间排查。
文档排版中的备注也一样
你在 Word 或 Markdown 里写‘此处图表将由设计提供’，结果图早就插进去了，备注还在。审稿人反复确认：‘图呢？怎么还没给？’这种低级误会，源头就是没清理的注释。
与其留个过期提示让人猜，不如在修改完成后顺手删掉或更新它。花十秒钟，省别人十分钟。
建立小习惯，比写注释更重要
每次提交修改前，快速扫一眼文档或代码里的注释。问问自己：这条现在还对吗？有没有变成‘僵尸信息’？团队协作时，甚至可以把‘清理无效注释’纳入检查清单。
注释本身没错，错的是让它自生自灭。它不是墓志铭，而是路标，指错了方向，反而更容易迷路。