这是一个创建于 2534 天前的主题，其中的信息可能已经有所发展或是发生改变。
这程序员要求英语几级啊，是不是需要 8 级以上啊
第 1 条附言 2018-12-23 07:43:09 +08:00
现在感觉好多了，因为不怎么看以前的代码了 ;) 。
写注释，主要是当时想要的功能和结果有个明确的目标，在设计之初的语境中，整理思路该如何着手。在实现过程中的每个函数对象，思路不是从头开始的，而是在具体的事物中，于是看某一段代码时，总会有为什么这样写，为什么不那样呢？思路随着现在的语境的延伸，越看越是糊涂，只有按照当时的语境重新整理思路后，才会原来当时是想干这个的顿悟。这样，短了还好说，代码长了就不好看办了。
写注释，主要是当时想要的功能和结果有个明确的目标，在设计之初的语境中，整理思路该如何着手。在实现过程中的每个函数对象，思路不是从头开始的，而是在具体的事物中，于是看某一段代码时，总会有为什么这样写，为什么不那样呢？思路随着现在的语境的延伸，越看越是糊涂，只有按照当时的语境重新整理思路后，才会原来当时是想干这个的顿悟。这样，短了还好说，代码长了就不好看办了。
 | 1 GDC 2018-12-22 14:27:43 +08:00 via iPhone  1 写中文 或者双语 |
 | 2 likuku 2018-12-22 14:35:02 +08:00 1 试试念个写作班？写的时候把“读者”定位成纯小白，或许会好点。 |
 | 3 DonaldY 2018-12-22 15:01:31 +08:00 1 题主想说： 1. 英语不好 - 》注释写不好？ 2. 英语不好 - 》代码写不好？ |
 | 4 yidinghe 2018-12-22 15:02:08 +08:00 2 楼主写中文注释是否有困难 |
 | 5 SeaRecluse 2018-12-22 15:44:02 +08:00 1 为什么要写注释，合理的命名+逻辑+文档才对，个人调试用的也没必要上非母语啊？ |
 | 6 AvenirX 2018-12-22 16:06:34 +08:00 via iPhon 1 你可以写完了放到谷歌翻译翻成中文，然后修改到你能看懂中文为止。下次看不懂自己注释了你就谷歌翻译一下 |
 | 7 kindjeff 2018-12-22 16:50:38 +08:00 1 稍微长一点的注释我都用专门切一下输入法用中文，不是看不看得懂的问题是我不会写。 |
 | 8 huangzhe8263 2018-12-22 16:52:39 +08:00 via Android 2 当我写注释的时候，我和上帝知道我在写什么。 过段时间当我回头看的时候，只有上帝知道了。 |
 | 9 lueffy 2018-12-22 17:00:25 +08:00 via iPhone 1 只是写代码不是看英文书籍的话 我觉得对英语水平高中水平就绝对够了啊或者有检索的能力就行 一般也就方法 /变量 /类的命名，使用欧路 /有道 /谷歌等翻译一下就行啊 保证中文翻成的英文，再翻回中文时，意思是一致的就行 就算你下次再见到不认识，再用软件翻译下就行了 总之千万不要用拼音缩写，别人真的很难读懂 |
 | 10 atonku 2018-12-22 17:25:57 +08:00 你肯定是翻译的英文，哈哈哈哈 |
 | 11 asLw0P981N0M0TCC 2018-12-22 17:29:18 +08:00 写注释要英文吗。。为什么不直接用中文啊 我都中文的。。虽然不太美观 |
 | 12 msg7086 2018-12-22 19:11:10 +08:00 1 首先，你说的 8 级是什么？ CET 大学英语等级考试只有 4 级和 6 级，没有 8 级，你想考也没这个项目给你考。 如果是说专业英语的 TEM4 级和 8 级的话，是给英语专业学生考的。你是英语专业的吗？如果不是，那你报名都不能报。 然后说注释的问题。如果你英语表达不流畅，那么用中文或者双语是很好的选择。注释的目的是要让人看懂，中文当然最方便让人看懂了。如果你们代码贡献者里有非中文使用者，那么写双语也是很好的。 |
| 13 msg7086 2018-12-22 19:14:07 +08:00 1 另外注释不一定仅限于文字。有些例子你用 ASCII 字符画都可以，比如流程图直接画在注释里，可能可以解释得更清楚。我们有些复杂的 Story 我都是先写一份 LaTeX PDF 的详细文档，把前前后后全部说明清楚，把 PDF 附在 Story Ticket 里，再在代码里引用这个 Ticket ID。这样任何时候我要回顾历史，都可以找到详细的说明材料。 |
 | 14 JasonCao2018 2018-12-22 21:21:51 +08:00 首先、请老老实实用中文 |
 | 15 OMan 2018-12-22 21:24:39 +08:00 1 我这过了 6 级的，还不是老老实实写中文注释，  |
 | 16 akira 2018-12-22 22:33:22 +08:00 1 自己写的注释 ，自己都看不懂的话，那是表达能力有问题，就算你写的是中文，一样有可能看不懂 |
 | 17 jingyulong 2018-12-22 22:39:45 +08:00 via iPhone 好的代码是不需要注释的，加油 |
 | 18 mason961125 2018-12-23 00:34:30 +08:00 你自己的代码如果命名规范、逻辑清晰、结构合理，不需要很多注释就能看懂。 |
 | 21 frittle 2018-12-23 07:27:38 +08:00 自己写得注释自己看不懂应该和使用那种语言无关吧，应该和自身的表达能力或语言组织能力有关。 |
 | 22 TonyLiu2ca OP 1 @GDC @yidinghe @qwertyzzz @JasonCao2018 必须英文 @likuku 我就是老小白 @DonaldY 是真的注释写不好 @SeaRecluse 我的教育阶段都说注释衡量是否是一个合格的程序员的， @AvenirX 谷歌的翻译很多时候不太好 @kindjeff 勇于承认，这就是勇者 @huangzhe8263 真是这样 @lueffy 真没试过拼音，这个比较的有创意 @atonku 真不是，自己硬写 @msg7086 双语也是好主意 @msg7086 这个比写程序花的时间还长吧。不是学文科的，美术特别不好。 @OMan 就说你，偷懒 @akira 中文的话，98%保证可以看懂 @jingyulong 牛，牛 @mason961125 不看注释，还真是更好看些 @xuanwu 个人的尽量全部中文 |
 | 23 ys0290 2018-12-23 08:14:37 +08:00 via iPhone 1 是不是当时以为懂所以写得很简洁，之后忘了不懂了就感觉是天书了 |
 | 24 hjw45611 2018-12-23 09:11:48 +08:00 via iPhone 1 多看看 重构:改善既有代码的设计 这本书 |
 | 25 lxerxa 2018-12-23 09:44:04 +08:00 via iPhone @jingyulong 赞同，好的代码本身就是注释了 |
 | 2 OldPanda 2018-12-23 11:43:13 +08:00 这很正常，这个时候就该考虑重构了 |
 | 27 niubee1 2018-12-23 11:53:53 +08:00 1 好的注释应该包含下面几个部分 1. 标题: 这段代码的助记名称 2. 用途: 这段代码的用途 3. 逻辑: 说明代码运行的逻辑, 可能的话包含逻辑图之类的, 用转 ascii 图工具转义好贴进去 4. 参数说明表: 每个参数的名称, 类型, 限制 5. 返回值说明: 类型, 6. 异常表, 如果语言不支持异常而是通过返回错误, 那么在上面一项说明 4. 调用示例: 如何调用这段代码的例子 不过这么干的话, 注释比代码正文都长, 我估计国内是没有公司会吃饱了撑的这么写 |
 | 28 wolfie 2018-12-23 14:30:03 +08:00 注释跟英语有什么关系。 |
 | 29 SuperMild 2018-12-23 15:52:23 +08:00 2 @xuanwu 说到中文编程，很多人会说来回切换输入法麻烦，但明明注释和一些字符串也很多人用中文，怎么就不嫌麻烦了。 |
 | 30 2kCS5c0b0ITXE5k2 2018-12-23 16:37:43 +08:00 为什么一定要写英语呢... |
 | 31 lepig 2018-12-24 00:20:21 +08:00 团队最好用中文 还要考虑下别的队友。 |
 | 32 jorneyr 2018-12-24 09:02:36 +08:00 写好后让其他队友再看一遍, 能否容易理解 |
 | 33 Evilk 2018-12-24 15:10:37 +08:00 我写释,一般都是中文 |
Select Language