今天查看activiti的README，突然发现一段很有意思的FAQ。

Why do you not accept @author lines in your source code?Because the author tags in the java files are a maintenance nightmareA large percentage is wrong, incomplete or inaccurate.Most of the time, it only contains the original author. Many files are completely refactored/expanded by other authors.Git is accurate, that is the canonical source to find the correct author.Because the author tags promote code ownership, which is bad in the long run.If people work on a piece they perceive as being owned by someone else, they tend to:only fix what they are assigned to fix, instead of everything that's brokendiscard responsibility if that code doesn't work properlybe scared of stepping on the feet of the owner.Credit to the authors is given:with Open Hub which also has statisticsin the GitHub web interface.

问题：为什么不在源码中使用 @author ？

首先，@author 是什么？

Java 文档注释标签。
其他常用的有：

@author 作者
@param 输入参数的名称说明
@return 输出参数说明
@since JDK版本
@version 版本号
@see 链接目标
@throws 异常
@deprecated

为什么不用？

activiti作者认为：

不利于java文件的后期维护。
对于长久来说，为代码标明所有者是很糟糕的事情。
代码版本工具提供了作者的提交历史记录，不需要再单独标识。

我觉得说的很有道理！

但是，公司内部的管理来说，有些人就是喜欢打上程序员的标签。
好吧，全世界的问题都是程序员的错！

java中到底该不该用@author标识作者？相关推荐

华为二面！！！面试官直接问我Java中到底什么是NIO？这不是直接送分题？？？
华为二面!!!面试官直接问我Java中到底什么是NIO?这不是直接送分题??? 什么是NIO 缓冲区(Buffer) 缓冲区类型获取缓冲区核心属性核心方法非直接缓冲区和直接缓冲区非直接缓冲区 ...
c#获取对象的唯一标识_在 Java 中利用 redis 实现分布式全局唯一标识服务
作者: 杨高超 juejin.im/post/5a4984265188252b145b643e 获取全局唯一标识的方法介绍在一个IT系统中,获取一个对象的唯一标识符是一个普遍的需求.在以前的单体应用 ...
java的继承啥考点,java中到底什么是继承？
1.何为继承?What is Inheritance? 在上图中,对于车来讲,汽车就是子类.对于汽车来讲,奔驰就是子类.车是汽车的基类,超类,或说父类.到底什么是继承?马克-to-win,子类把父类的 ...
java中到底什么是抽象？
抽象Abstract:[新手可忽略不影响继续学习] 很多java 的书中都谈到了抽象abstract的概念,到底什么是抽象?马克-to-win:抽取关键相关特性(属性和方法)构成对象,用程序的方 ...
java 有指针吗_java中到底有没有指针（转）
学过c/c++,然后学java的人往往心中有此纠结,java中到底有没有指针? 如果一定要在是或否里选择一个,OK,java中没有指针. 那么,java中的引用(reference)和c/c++中的指 ...
请注意，java中没有引用传递
今天在论坛上有人提了一个关于java中调用函数时有没有引用传递的问题,可谓是吵的不可开交.有人说java只有值传递,也有人说java既有值传递也有引用传递,那么java中到底有没有引用传递呢,下面我来 ...
为什么说 Java 中只有值传递？
对于初学者来说,要想把这个问题回答正确,是比较难的.在第二天整理答案的时候,我发现我竟然无法通过简单的语言把这个事情描述的很容易理解,遗憾的是,我也没有在网上找到哪篇文章可以把这个事情讲解的通俗易懂. ...
java中的md5加密_java中的MD5加密
java中的MD5加密 2016-01-22 09:07:00 admin 原创 1144 摘要:java中的MD5加密 /** * * md5加密 * @author LiuJiawan * @da ...
为什么说Java中只有值传递(另一种角度)
转载自为什么说Java中只有值传递对于初学者来说,要想把这个问题回答正确,是比较难的.在第二天整理答案的时候,我发现我竟然无法通过简单的语言把这个事情描述的很容易理解,遗憾的是,我也没有在网上找到 ...
为什么Java中只有值传递
原文链接:https://www.cnblogs.com/wchxj/p/8729503.html 在开始深入讲解之前,有必要纠正一下大家以前的那些错误看法了.如果你有以下想法,那么你有必要好好阅读本 ...

java中到底该不该用@author标识作者？

问题：为什么不在源码中使用 @author ？

首先，@author 是什么？

为什么不用？

我觉得说的很有道理！

java中到底该不该用@author标识作者？相关推荐

最新文章

热门文章