Re: [閒聊] 寫code不加註解真的很顧人怨嗎
還好八
反正註釋這種東西,也太詳細也沒人看
最多就函式功能、輸入輸出寫寫
然後複雜的演算法寫寫
我覺得程式寫的清楚比較重要
原廠給我的code,每個模組都用一堆全域變數
單獨跑可能還好,要讓兩個模組一起跑就各種奇怪的問題
測試也不全面
開發到一半,發現硬體動不起來
拿示波器測波形也沒出來
最後邊看code 邊看手冊 才發現他時鐘樹設錯 要自己除PLL頻率改參數
本來以為這已經很誇張了
但我同事會寫這樣的code
有個需求是調整倍率 然後調整之後 要在畫面上顯示一段時間消失
1、1.5、2、2.5、3這樣
通常來說可能就是
label、設定倍率(倍率)、timer(秒) 這樣的組合
先用設定倍率(倍率)設定label的值,然後設個timer多久隱藏
然後他這樣寫
label[0]
label[1]
label[2]
label[3]
label[4]
timer0
timer1
timer2
timer3
timer4
每個label都是固定文字,選到哪個就用對應的定時器顯示N秒後消失
https://i.imgur.com/CLs8LGE.png

相比之下 我覺得註釋根本就可有可無
--
這才是實務經驗 註解根本不可信 浪費時間
你都說完了還有什麼問題
反正最後編譯起來都會變成沒有意義的文字(?)
實務經驗個屁啊,過猶不及。
還好吧,這樣寫到時候改成別的訊息很方便啊
當註解寫Dont remove 或Dont modify配上一個十年前的
日期以及一個不在的人命,敢改就看你八字夠不夠重
這個寫法就是實務上可行,但我前公司的code review只
要看的人用0.5就可以讓對方飛到天花板上
當然你們如果沒有這樣的code review那我也沒差
能讓人飛到天花板的理由很簡單,你現在知道要求是1/1
.5/2/2.5/3倍,那你身為一個合格的員工應該要想像到
以後會有0.25/1.75等需求,在沒有特別要求的情況下就
應該自動刻出一個generalize的功能
老實說這理由很見正大光明,我看到誰被電的話也只會
笑他活該,但你們公司如果不想這樣電人也不是不行
你是不是沒看過主管沒一個會軟體的公司
你同事的寫法才是比較實在的,你講的hard code寫法才糟
能動就好
遇到這種奇葩的PG同事,你還忍得住算你猛。
爆
首Po餓死抬頭 本魯不是資工系的啦 所以不知道寫程式不加註解會有多嚴重 想請問相關從業的鄉民![[閒聊] 寫code不加註解真的很顧人怨嗎 [閒聊] 寫code不加註解真的很顧人怨嗎](https://i.imgur.com/3QcIsVNb.jpeg)
60
大家好 我月薪28k軟體工程師啦 我的觀察齁 程式設計師有好幾種類型 1. 無口型 做了很奇怪的事也不註解,commit也找不到原因 等到哪個有重構強迫症的改壞程式以後才發現原來看似很奇![Re: [閒聊] 寫code不加註解真的很顧人怨嗎 Re: [閒聊] 寫code不加註解真的很顧人怨嗎](https://img.youtube.com/vi/dQw4w9WgXcQ/mqdefault.jpg)
11
最好的作法是 盡量把程式寫得清楚簡單易懂好理解 這樣就不需要加註解了 註解是拿來用在解釋特殊情況 也就是![Re: [閒聊] 寫code不加註解真的很顧人怨嗎 Re: [閒聊] 寫code不加註解真的很顧人怨嗎](https://www.redditstatic.com/shreddit/assets/favicon/192x192.png)
30
以下是根據本魯碼農自己的經驗,絕大部份參考Clean Code這本書,我自己是將這本書奉為 圭臬,不過我也知道很多人反對書裡的一些看法,所以聽聽就好 首先一個最大的原則就是程式碼必須好懂,因為它同時是寫給機器跟人看的,好懂是可擴充 性跟可維護性的必要,是程式碼無比重要的基石 推文有人說程式碼沒有註解的話十年後的自己會無法理解,實際上根據我自己的經驗如果我![Re: [閒聊] 寫code不加註解真的很顧人怨嗎 Re: [閒聊] 寫code不加註解真的很顧人怨嗎](https://i.imgur.com/QdO4bqqb.png)
24
真的有這麼奇葩的註解嗎 上 code 前不是都會做 code review 嗎 現在很多工具除了會做 style check,commit message 之外, 甚至有些工具會檢查註解是否符合格式吧 這種亂上 code 真的不會被幹到起飛嗎
23
Re: [討論] 怎樣算是一個合格的junior cpp programme針對關於 TDD 的討論另外回一篇好了 覺得用推文太長了 XD : 推 stupidlove0: 朝聖!重要的真的是unit test 08/23 18:47 : → HZYSoft: 回樓上 TDD 問題,TDD 不只要測試,還要先寫測試才寫code 08/23 21:33 : → HZYSoft: 很多人無法習慣這種順序,是否一定要 TDD 這有爭議 08/23 21:3417
Re: [問卦] 人人都會寫code,工程師飯碗不保?所以才看的出素質高低啊! 有些程式維護起來累得半死,不寫註解、全域變數亂宣告、變數何處被改都不知道、沒有 物件導向觀念,程式一堆複製貼上、一堆函式參數亂丟、 一堆無意義迴圈、一堆奇奇怪怪的判斷,很愛自己亂幹邏輯、 程式碼排版雜亂不堪…14
Re: [討論] 用AI寫code產生的疑問其實很多新技術在早期和成熟後相比你會感覺他的應用是完全顛覆最初想法的 例如 web 仔最熟稔的 web 好了,網路泡沫時代前大家對電子商務 的觀點是在網路上的一個廣告頁,每個網站就像一間街邊店一樣,透過網址 這串虛擬地址你可以造訪網路上的任何一間店,找到你要的資訊,更容易媒合實體交易 當時的 web 就是一本電話簿的概念12
Re: [請益] 該停損了嗎?你好,開始的過程特別辛苦,但應該可以再試看看。 你程式基礎不夠之外,做事的方法也需要調整, 這兩件事情其實可以藉由工作的實戰一起解決。 我建議你不要再抄寫書上的 code 了, 那離你工作要處理的問題太遠,對你幫助很小。8
Re: [討論] 沒中文說明沒sample code是不是很難寫?小弟我曾經碰過一個要用樹梅派控制gps module的案子 簡單來說,就是要用UART Tx送指令進模組,那模組理論上就會吐回資料 但當我拿到那個gps 的spec 時,整個spec有40~50頁都在談那個模組的設定 譬如說你寫不同的register就會掃不同的頻率或是工作電壓等等 但當時我是gps的新手,就算我當時已經有6年的fw年資,可是這完全不代表7
[討論] 在 .NET 使用 Pythonnet 的應用情境板上各位大大好 最近工作有接觸到 Pythonnet 想請教一下有使用過 Pythonnet 大大的經驗 我們部門軟體的核心架構是使用.NET ( UI, Custom Class, Custom Collection... ) 為了使程式外部化,將部分功能的模組寫在 Python3
[問題] Automachef 自動化餐廳 AC16/32 電腦 la官方的說明跟大部分網路討論都是直接寫code的 看起來(應該好像)是在特定程式段開頭結尾加上label 但Switch上只有GUI 試了一下label不能像其他的commend可以把別段整段框到下面 然後試著在開頭結尾加label![[問題] Automachef 自動化餐廳 AC16/32 電腦 la [問題] Automachef 自動化餐廳 AC16/32 電腦 la](https://external-preview.redd.it/HcNIlfJq25uaRWpBcWcUvVwp8EvlZbxPSqaM2og6Y7Q.jpg?width=464&height=242.931937173&auto=webp&crop=464:242.931937173,smart&s=26838406576e3d28f5a65cf4090d66053baa5772)
X
Re: [討論] 請問測試驗證工作這個系列應該不太有人會回應 大過年 簡單回應一下好了 結論:沒有壓力 1. 寫程式方面: 記憶體主要是memory array 驗證會比較複雜