【轮不写注释，文档不好，项目团队换了好几批】

程序员一灯 2014-03-23 01:13:29

如题：
1、不写注释
2、文档很长时间没跟新，很多新功能没有文档
3、项目团队换了好几波了

还有很多代码完全是些出来没有测过。
比如：action返回值，在struts xml中没有对应的，最后一点就报错。

比较坑爹的是这个项目每天还给测试部门测试，测试部门从来没有发现。。。

现在刚刚接手，你觉得蛋疼吗？

...全文

387 23 打赏收藏转发到动态举报

写回复

23 条回复

切换为时间正序

请发表友善的回复…

发表回复

bfdeh 2014-04-09

打赏
举报

回复

引用 22 楼 zhou9898 的回复:

[quote=引用 19 楼 bfdeh 的回复:] 意思是你多少还有些文档，楼主，你过来，我给你看看我们公司的代码。完！全！木！有！文！档！

那是敏捷开发么？[/quote]那是小作坊开发

程序员一灯 2014-04-04

打赏
举报

回复

引用 19 楼 bfdeh 的回复:

意思是你多少还有些文档，楼主，你过来，我给你看看我们公司的代码。完！全！木！有！文！档！

那是敏捷开发么？

查看余e 2014-04-04

打赏
举报

回复

零度的折翅 2014-04-04

打赏
举报

回复

真是什么都有呀！！！太TM坑呀！

bfdeh 2014-04-04

打赏
举报

回复

意思是你多少还有些文档，楼主，你过来，我给你看看我们公司的代码。完！全！木！有！文！档！

正宗熊猫哥 2014-04-04

打赏
举报

回复

LZ蛋疼即可，我不蛋疼

低调是种无声的高调 2014-04-04

打赏
举报

回复

方便面一天就知道水，明天别来上班了

快乐的2 2014-04-04

打赏
举报

回复

需求都是猜的项目你干过吗?

红桃Arrow 2014-03-31

打赏
举报

回复

欢乐的小猪 2014-03-31

打赏
举报

回复

qwe369161 2014-03-29

打赏
举报

回复

程序员一灯 2014-03-24

打赏
举报

回复

引用 2 楼 boxmanstan 的回复:

式样书都不确定的活你干过吗

你说的是需求的吧？这个没啥的，敏捷开发不就解决这个的嘛。。。

SweetTimeRose 2014-03-24

打赏
举报

回复

如果大海能够，带走我的矮丑，那就只剩下穷了

盐酸地芬尼多片 2014-03-24

打赏
举报

回复

举手无悔大丈夫 2014-03-24

打赏
举报

回复

啊呀 2014-03-24

打赏
举报

回复

HelloBitches 2014-03-23

打赏
举报

回复

对我有用[0] 丢个板砖[0] 引用 | 举报 | 管理

jxjjljf 2014-03-23

打赏
举报

回复

程序猿的作用就在这里

猴头 2014-03-23

打赏
举报

回复

熊熊大叔 2014-03-23

打赏
举报

回复

CMM 1级

加载更多回复（2）

本文同步发表于我的微信公众号，扫一扫文章底部的二维码或在微信搜索 HelloWorld杰少即可关注。如何看待程序员不写注释？ “几个月前，我写的代码只有我和上帝知道” “现在，只有上帝知道了” 最近在知乎上看到了这个话题：怎样看待程序员不写注释？看了下浏览量居然有 30+w 次，看来大家讨论的挺热闹，我浏览了大部分的回答，发现大家的观点可以归纳为以下几点：不写注释就是害人害己，别人看不懂，过几天连自己也看不懂好的代码就是最好的注释，我的代码可读性很好，没必要写注释只要有完善的文档，代码.

注释的目的在于提高代码的后期维护性，也就是说花费了当前的工作时间换取以后节约更多的时间。一次性代码、以后不需要维护的代码实际上不需要写注释。结构清晰简单、很容易维护的代码可以少写甚至不写注释，写多了注释反而会降低工作效率。代码越复杂越不容易维护，维护的人越是参差不齐，越是需要认真写注释。判断注释、文档写的够不够其实很容易验证。如果代码将来也还是自己维护，那就找找几年前自己的代码，看

在JavaScript中，文档注释是一种特殊的注释格式，用于描述代码的功能、使用方法、参数、返回值等信息。文档注释通常使用特定的注释标记和结构来表示，并且可以通过工具解析生成文档。在JavaScript中，常用的文档注释格式是使用 /** 和 */ 括起来的多行注释。/*** 这是一个示例函数，用于加法运算。* @param {number} a - 第一个操作数* @param {number} b - 第二个操作数* @returns {number} - 两个操作数的和。

最近做的项目，因为看别人的代码，没有注释，看的简直头疼。代码注释，是一个程序员最基本的素养，因为写的代码，不只是给机器去执行的，还需要给自己看，给继任者看，给同项目小伙伴看注释是一个磨刀不误砍柴工的活，自己阅读起来会快；大家都写注释，互相了解起来方便如果真的开发任务很重，可以把握优先级，把核心的注释写好有的同事，觉得自己命名没问题，逻辑没问题，就可以不用写注释这样的好习惯，的确可以少些一部分注释，不过所以没有理由不写注释，注释写的好，不见得是好程序员；注释写不好，肯定不是好程序员！单vue文件、js文

很多程序员不习惯写注释。甚至是一些比较底层的函数都不写注释。过一段时间后调用时候，就不得不去查看实现代码，才能知道某个边界值的判断是否在函数实现中判断了。如果手工检查是否写注释的话，很多时候因为工作一忙，就走与形式了。前几天我的同事说在VS2005中找到的一个超简单的方式来强制写注释，如果公共函数没有写注释，或者注视书写错误，编译程序的时候就会报警告。这个设置就是我们很多人都知道的定义

594

社区成员

254,047

社区内容

发帖

与我相关

我的任务

其他技术论坛（原bbs）

社区管理员

加入社区

近7日
近30日
至今

加载中

查看更多榜单

社区公告

暂无公告

试试用AI创作助手写篇文章吧

+ 用AI写文章