接手一个项目，看别人的代码好痛苦，注释都没有

注释

接手

代码

痛苦

39 条回复 • 2016-02-02 11:54:11 +08:00

1

yurivvvvv

2016-01-11 14:14:13 +08:00

好的知道了。

2

tomwei7

2016-01-11 14:38:55 +08:00

嗯

3

axknightroad

2016-01-11 14:44:03 +08:00

知道了，你可以继续去看代码了

4

dark456852

2016-01-11 15:37:14 +08:00

知道了，就这样

5

xylophone21

2016-01-11 15:41:38 +08:00

你确定注释不属于躺枪？

6

tempuseraccount

2016-01-11 15:44:58 +08:00

习惯了就好了。
无注释无文档，项目经手多人，代码风格迥异，各种莫名其妙的 hack 。这是常态

7

wingyiu

2016-01-11 16:29:43 +08:00

好代码不需要注释

8

Anybfans

2016-01-11 16:31:37 +08:00

不知道这个算不算有注释的代码。。

9

zzn

2016-01-11 16:34:49 +08:00

有的时候有注释还不如没注释

10

evakiss

2016-01-11 17:01:50 +08:00 via Android

我一般写 01 机器码来写程序，为了防止别人看不懂，都是附加了 Python 作为注释的，遇到小白还要双斜杠 PHP 代码作为注释，好累

11

qurioust

2016-01-11 17:16:31 +08:00

@Anybfans 是 django 么

12

wangyongbo

2016-01-11 17:24:50 +08:00

@qurioust 据我目测，是 django 。

13

wangyongbo

2016-01-11 17:26:28 +08:00

我觉得如果看没有注释的代码感觉很痛苦，是因为代码写的不够好。

最近，我一边看 tastypie 的代码，一边写应用，发现人家写的代码，比文档还要容易懂。

差距太大了。

14

Anybfans

2016-01-11 17:27:03 +08:00

@qurioust
@wangyongbo 嗯。。是 django.
算是新人啊。不知道这样注释合适不合适。

15

elgoog1970

2016-01-11 18:37:14 +08:00

好的，我以后尽量加上注释!!!!

16

stdying

2016-01-11 19:08:06 +08:00

多少行

17

cxbig

2016-01-11 19:10:58 +08:00

看到哪把注释补充道哪，这么好的锻炼机会还不赶快抓住

18

pagxir

2016-01-11 19:16:44 +08:00 via iPad

1

一般我写注释是用来解释为什么这么干。至于干了什么，除非确实很难看懂，否则不写。

19

m1911star

2016-01-11 19:28:29 +08:00

@Anybfans 6666,心疼

20

void1900

2016-01-11 19:44:03 +08:00

其实注释没多大卵用

21

iiilii

2016-01-11 19:45:37 +08:00

好的代码会自注释的

22

doublepeng

2016-01-11 19:55:29 +08:00

最近同接手项目，没办法，从日常维护开始看原理。 Python 项目，看懂很快的。

23

twoyuan

2016-01-11 21:35:42 +08:00

老段子，程序员最讨厌的四件事：
1. 写文档
2. 写注释
3. 看没有文档的项目
4. 看没有注释的代码

24

louk78

2016-01-12 08:43:05 +08:00

老段子，程序员最讨厌的四件事：
1. 写文档
2. 写注释
3. 看没有文档的项目
4. 看没有注释的代码

25

sprinng

2016-01-12 09:15:11 +08:00

一样一样的

26

pyengwoei

2016-01-12 09:27:42 +08:00

看这个哈哈 https://www.v2ex.com/t/245653#reply55

27

Immortal

2016-01-12 10:00:17 +08:00

@Anybfans 是 sublime 吧？请问字体和主题是？

28

Scoield

2016-01-12 10:23:31 +08:00

其实我也不喜欢注释，命名好一点一看就懂……

29

Anybfans

2016-01-12 10:24:53 +08:00

@Immortal 是 sublime
主题是 meterial

"color_scheme": "Packages/Material Theme/schemes/Material-Theme.tmTheme",
"theme": "Material-Theme.sublime-theme",
"font_face": "Consolas",

30

Anybfans

2016-01-12 10:25:23 +08:00

@Anybfans 主题地址 https://github.com/equinusocio/material-theme

31

wangdonny

2016-01-12 10:43:36 +08:00

最近在看 clean code ，豁然开朗，好代码是自注释的，有了注释，反而容易让代码变臃肿不易理解

32

shajiquan

2016-01-12 13:27:35 +08:00

@Anybfans 好注释……+10010

33

roys

2016-01-12 14:26:20 +08:00

就算有注释一样痛苦，兄弟顶住

34

nikola

2016-01-12 16:57:44 +08:00

@Anybfans 注释已经很详尽了

35

111111111111

2016-01-12 21:00:32 +08:00 via Android

@Anybfans
for 循环是不是可以精简一些？

36

lsxploc

2016-01-12 23:21:35 +08:00

代码结构清晰的话，还需要注释吗

37

atubo

2016-01-13 07:59:41 +08:00

每一个程序员接手代码的时候都抱怨没文档，没注释，但自己写的代码，也不写注释，也不写文档。

38

aitaii

2016-01-13 09:03:01 +08:00

@atubo 233

39

Tuisku

2016-02-02 11:54:11 +08:00

: ) 所以我实习离职的时候不小心把我写的 js 加密了一下后台变量改了一下 Int32 _;String __;String _0__;