[討論] 註解 用中文還是英文

作者: x246libra (楓)   2018-03-05 12:37:08
非本科 近了一家小公司 學著寫程式
本身英文不好
英轉中還可以看懂
中轉英常常想不到用什麼詞
勉強靠GOOGLE用些簡單的單字
讓變數或函數 為有意義的命名
但是註解通常要寫的比較詳細
用英文總是思考很久,也不確定文法是否正確
想請問板上的其它人 註解是用中文還是英文寫?
作者: ezaki (御坂小衣)   2018-03-05 12:51:00
以公司的人看得懂和交接方便說明為主
作者: pttworld (批踢踢世界)   2018-03-05 12:51:00
UTF-8的用中文我覺得可以
作者: robler (章魚丸)   2018-03-05 12:52:00
你喜歡就好
作者: Boston (Boston)   2018-03-05 13:05:00
英文就算是 UTF-8 好了,但寫個註解還要切輸入法 不覺得麻煩嗎
作者: alanturing (alan)   2018-03-05 13:06:00
註解是寫給人看的 看的人能快速看懂才是重點
作者: robber1234 (超痛恨嘴炮)   2018-03-05 13:48:00
英文.除非你真的沒法那就中文.中國人超愛寫中文註解
作者: crossdunk (推噓自如)   2018-03-05 13:50:00
我都寫繁體中文,給你參考
作者: vi000246 (Vi)   2018-03-05 13:52:00
看是要給誰看的 要給外國人看就寫英文
作者: simonjen (狂)   2018-03-05 13:57:00
我們公司有人直接用中文當變數,給你參考!
作者: x246libra (楓)   2018-03-05 14:03:00
中文當變數 也太誇張XD
作者: keith222 (Keith)   2018-03-05 14:10:00
stackoverflow 上都有人用阿拉伯文變數問問題了
作者: cphe (魔鬼藏在垃圾筒裡)   2018-03-05 14:16:00
註解就其他人看得懂最重要,文法不用太在意當然你如果文法錯太誇張讓人看不懂,可以考慮把英文學好
作者: hizuki (ayaka)   2018-03-05 14:24:00
水平好用英語,期待接手的人看不懂咯
作者: alihue (wanda wanda)   2018-03-05 15:12:00
如果都是一些中文專有名詞,中文變數好用啊
作者: dsilver (細數遠星永唱泉水)   2018-03-05 16:11:00
接手的人看不懂,你在公司才有價值(咦)
作者: PUTOUCHANG (自己的廢文自己發)   2018-03-05 16:22:00
你可以用英文再加個 text 版的 doc 說明文件像 Linux kernel 的 Documentation 降
作者: leolarrel (真.粽子無雙)   2018-03-05 16:31:00
推dsilver
作者: brianhsu (墳墓)   2018-03-05 16:38:00
如果公司的開發者母語都是中文,而且這個程式碼也不需要給第三方,我會寫中文。
作者: yyc1217 (somo)   2018-03-05 16:46:00
給誰看就用彼此共通的語言
作者: johnny94 (32767)   2018-03-05 17:00:00
編碼沒問題就用中文阿,註解就是要讓人家看懂的。
作者: sunsamy   2018-03-05 17:28:00
程式碼是最好的註解,若辦不到代表程式水平很差,連命名都有困難,例如某作業系統的/dev/,/tmp/,fs,ls。然後再寫註解:dev is device, tmp is temp, fs is file systemls is list。這就是脫褲子放屁了。真的好的註解是連這個區塊,function在做什麼都不用寫,看式碼,名子就略知一二
作者: peanut97 (丁丁)   2018-03-05 17:41:00
公司的人都講中文,所以我都用中文
作者: coronach (...)   2018-03-05 18:25:00
自從多年前接手中國code被GB碼炸過,我打死都不會寫中文註解在code裡如果你的註解用英文寫不出來,那只有兩個可能:1.你要寫的東西複雜到應該寫在文件裡 2.你的英文程度爛到不該當工程師
作者: ku72 (ku72)   2018-03-05 18:40:00
中文習慣就寫中文
作者: NCUking (中大王)   2018-03-05 18:59:00
拜託用中文寫就好 英文不好還硬要寫只是浪費隊友時間
作者: sextitanic   2018-03-05 19:38:00
看你拿到的規格文件跟你同事的共通語言
作者: stfang925 (司馬鈴薯)   2018-03-05 19:42:00
只有拿到檔案裡有中文時才會打中文 其他全部英文
作者: kevin80112 (加油好嗎)   2018-03-05 20:52:00
連變數名稱都要GOOGLE建議用中文
作者: descent (「雄辯是銀,沉默是金」)   2018-03-05 21:00:00
我用英文是因為怕亂碼, 其實我想用中文
作者: winddust (喬狼)   2018-03-05 21:02:00
程式中英文混雜,若是Linux下寫shell,都用英文,主要是受預設編碼這個變數影響,都要去try charset設定,用英文省事
作者: abccbaandy (敏)   2018-03-05 21:34:00
中文有時候真的找自己麻煩,尤其環境不能控制的時候
作者: LinuxKernel (Linus Torvalds)   2018-03-05 21:45:00
當然英文啊
作者: mathrew (Joey)   2018-03-05 22:21:00
英文 有時候會有編碼問題
作者: dreamnook (亞龍)   2018-03-05 22:44:00
用拼音寫註解(前同事遇過
作者: tw689 (台灣689)   2018-03-05 22:44:00
你英文好就英文,英文不好就中文 反正大多其實是給自己看的
作者: clamperni (肥宅牛牛)   2018-03-05 22:56:00
中文
作者: goths5958 (德克斯特)   2018-03-06 00:44:00
先想清楚註解是為了什麼而寫 就會知道要怎麼選擇
作者: eva19452002 (^^)   2018-03-06 06:28:00
dirty code才需要註解,clean code只需看variablename及function name就知道程式在做什麼了當然還有個前提是每個function內聚力要夠強
作者: cpper (韓立)   2018-03-06 07:25:00
說要寫英文的人何不在ptt也寫英文
作者: Vanses (Money~where r u )   2018-03-06 08:21:00
Definitely English. Unless you want your work can onlybe seen, checked and appreciated by Taiwanese and Chinese. Say you have a fancy work on Github which has description/inline comment written in Chinese. Only Chinese people will understand and appreciate it. You maytry writing the answer in Chinese on stackoverflow and see who will give you positive rating.
作者: nova06091   2018-03-06 08:29:00
A pen in my hole
作者: typepeter (∵Peter∴笑點)   2018-03-06 08:46:00
只限台灣人看的時候也許沒差 但編碼及維護性 英文較好
作者: nelley (名字:大便王)   2018-03-06 08:59:00
看交接給誰。。我中英日的都寫過。。。然後,如果你是大神,你寫台語都會有一堆人搶著看
作者: RadiationXen (Xen)   2018-03-06 09:06:00
團隊有人母語不是中文,或不需要把原始碼給第三方時,可以用中文。話說日本人也會用日文寫註解
作者: qweqweqweqwe (4qwe)   2018-03-06 09:49:00
有機會交接的人看得懂最重要 語言是拿來溝通的
作者: vn509942 (如履薄冰)   2018-03-06 10:13:00
英文不好,拜託不要假掰註解是寫給人看 不是寫給鬼看
作者: b086232 (星間聯絡船)   2018-03-06 12:20:00
可以參閱我的程式碼會說話,其中有個章節講這個部分。
作者: akira01 (小吉)   2018-03-06 13:04:00
給台灣與大陸人用繁體中文,給洋人用英文
作者: darkMood (瞬間投射)   2018-03-06 13:06:00
外國你當然就寫英文,台灣當然就寫中文啊,你不知道多少工程師英文都爛到爆嘛............................
作者: kaitokid1214 (羽)   2018-03-06 13:26:00
註解就你看得懂,你一個月後看還是看得懂,你一年後看還是看得懂,別人N年後拿來問你還是看得懂,這樣就好你要用摩斯密碼寫也OK
作者: NTULioner (LionsHeart)   2018-03-06 17:54:00
中文通常都額外寫在wiki或文件上吧
作者: q26766 (cancan)   2018-03-06 19:35:00
不會英文不能當工程師是啥邏輯
作者: soi1dsnake (索立德史捏克)   2018-03-06 22:24:00
我都用法文 給你參考
作者: stosto (樹多)   2018-03-06 23:34:00
註解頂多寫fucking code....那個時候作者就會自己修掉了
作者: Ghamu (貓丸)   2018-03-06 23:57:00
英文太爛 一句話不知道要有主詞 動詞 時態正確者 乖乖寫中文吧我是偏好寫英文 程式碼是英文 註解也是英文 你的大腦會少一層context switch 拖慢 而英文真的太差者 一般也難寫出可讀的程式碼之前看到有個func 叫做 go() 想說是要go to where? 喔 原來是start()的意思啊 幹你娘
作者: Ayukawayen (亞布里艾爾發芽>//<)   2018-03-07 00:12:00
可能有另一個function叫ready()
作者: luckyluck (肚臍)   2018-03-07 00:44:00
寫德文
作者: CHICHINGTSAI (CC)   2018-03-07 08:05:00
可能英文比較好喔!避免亂碼搞死後面接手的人還是同事
作者: markbex (馬克杯)   2018-03-07 10:37:00
同事和環境都中文就寫中文 要看英文就直接看code就好
作者: Csongs (西歌)   2018-03-07 12:58:00
與其讓下面寫些奇怪英文註解 不如用中文亂碼問題統一用utf8就好上面 go start我笑了XDD
作者: RumiManiac (Rumi!)   2018-03-07 13:06:00
go XDDDDDDD
作者: kenwufederer (Nash)   2018-03-07 15:22:00
看環境,不需要一定要用英文,讓人頭痛而已
作者: accessdenied (存取違規)   2018-03-07 17:22:00
不是所有的編譯器都認識UTF8, 用英文比較好。而且用go我覺得也沒什麼問題,很好理解。是閱讀人英文不好,把go和goto搞混。「去!」很直覺啊
作者: Ghamu (貓丸)   2018-03-08 02:54:00
想想英文或許也不用很好 應該說同一水平就好 都用台式英文也可溝通無障礙 不過我真的十分難理解明明官方api 範例程式碼 setup update put get 等等一堆尋常關鍵字眼不用 偏愛自己造新詞的傢伙在想什麼 我一直盡量想讓東西一致 可依循每次稍微畸形點到命名都在心裡懺悔 [幹...原諒我] 但好像有滿多人是跟著感覺走的 以自己為中心的覺得go 好的 請用go 造一個句子表示啟動一個task. 我用start. start a task 好了那 go呢?
作者: PUTOUCHANG (自己的廢文自己發)   2018-03-08 03:25:00
go(); segfault at xxx rip xxx rsp xxx error 6
作者: dapple (dapple)   2018-03-08 10:00:00
寫在code裡面的東西都用英文 不要寫中文之前就遇過注釋寫中文結果build break的事件
作者: robber1234 (超痛恨嘴炮)   2018-03-08 15:43:00
這麼多人贊成不需用英文,看得我心裡發寒大學甚至碩士畢業的高材生 英文寫不好還找理由嗎
作者: hegemon (hegemon)   2018-03-08 20:09:00
全部用英文呀,同事中文不好怎麽辦?
作者: littleyuan (baby)   2018-03-09 05:40:00
我自己是移民北美十幾年在全英環境科技公司工作 如果看到有人寫go也能理解 只是go比較有不同意思 start或許更直觀些
作者: Csongs (西歌)   2018-03-09 08:12:00
當你同事英文爛就知道了,review code大陸同仁還用漢語拼音參雜,整個昏倒
作者: johnson0403 (菜鳥上班族)   2018-03-09 19:23:00
看公司...還有區域 像我們在越南就註解要英越文了...
作者: lturtsamuel (港都都教授)   2018-03-14 16:40:00
看到有人寫個中文就發寒 我也心裡發寒
作者: bizer (bizer)   2018-03-26 01:02:00
不是所有compiler都吃中文,但英文是絕對可吃,遇過debug怎麼找都找不到問題的,結果是註釋不小心打了一個中文字

Links booklink

Contact Us: admin [ a t ] ucptt.com