背景

最近在项目中使用到了Dart中的注解代码生成技术，这跟之前Java中APT+JavaPoet生成代码那套技术还是有一些不同的地方，比如

• Flutter中在禁用了dart:mirror，无法使用反射情况下如何得到类相关信息？

• Dart的文件不限制是class，可以是function、class，因而在注解扫描的范围不同的情况下如何拿到层层信息而不仅仅是toplevel信息？

“王哥，王哥，代码又冲突了！”

“王司，王司，代码咋拉下来冲突了！”

走近一看，原来是代码注释的不一样，导致了代码冲突，我的血压就如上图一样。

自从到新公司后，这样的场景已经上演过很多次了。在多次"血淋淋的"事情发生后。终于在上周五，我们下定决心，要统一下代码的注释模板。解决这让人蛋痛的问题。

首先介绍下：我们使用的开发工具是大名鼎鼎的 "IDEA"。

作为程序员，阅读代码是日常工作的重要组成部分，尤其是那些开源项目或正在开发的软件。然而，代码中的注释常常会带来困扰。

IT之家 4 月 22 日消息，谷歌于今天发布新闻稿，宣布其聊天机器人 Bard 现支持使用 C++ 和 Typescript 等 20 多种语言编写代码。

IT之家翻译博文部分内容如下：

Bard 自现在开始，可以辅助完成编程和软件开发任务，支持代码生成、调试和注释等等。

Bard 支持 C++、Go、Java、Javascript、Python 和 Typescript 等 20 多种编程语言。开发者无需复制粘贴，轻松地将 Python 代码导出到 Google Colab。

之前有读者问，自己一直不明白如何写出合理的代码注释

这也是不少程序员一直头疼的问题，比如接手新代码时，没有注释，完全搞不清逻辑；自己写的注释，跟不上代码修改，成了误导；复杂逻辑不知道咋注释，别人也看不懂。

1、要养成边写代码边注释的习惯，程序员基本不会先写完代码再注释。代码不加注释，其他人很难读懂，即使是自己写的代码，没有注释自己再回头来读，也很费时。

2、代码加上注释便于后期维护。

3、注释可以增加代码的可读性。如下面的语句，可读性很差吧，但如果加上注释，即使没学过C，也知道这条语句的功能。

return((s1<s2) ? s1:s2);

注释语句是用来说明程序中某些语句的功能和作用；VBA 中有两种方法标识为注释语句。
单引号 ' 举例：

听说程序员最讨厌两件事，1.自己写注释，2.别人不写注释。如果有人对你说，我的代码很好，不需要注释，你的第一反应是什么？

最近，黑马君上网冲浪刷到这样一条帖子，一位程序员说：好的代码真的不需要注释！或许会被各种喷，但是我就是这么认为的！