← 返回卡片

原书出处

编写可读代码的艺术

核验版本的摘录快照 · 导入于 2026-11-14T02:00:39.582Z

总结 总结 注释的目的是

帮助读者了解作者在写代码时已经知道的那些事情。本章介绍了如何发现所有的并不那么明显的信息块并且把它们写下来。 什么地方不需要注释: ·能从代码本身中迅速地推断的事实。 ·用来粉饰烂代码(例如蹩脚的函数名)的“拐杖式注释”——应该把代码改好。 你应该记录下来的想法包括:

·对于为什么代码写成这样而不是那样的内在

此预览只包含定位所需的摘录和上下文。

原书定位详情

来源:a19c7933-4eda-4176-aebd-30fe7e1ad292

正文位置:extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2728.html

EPUB SHA-256:06582ecdf071724c9e218bc2698d2fff4e82a992d672b287e4c2e6092c924bcf

本卡其他出处