Re: [請益] 要如何說服同事停止命名類似iID的變數
※ 引述《FukadaKyoko (小毛哥)》之銘言:
: 現在的專案中很多人會使用例如:
: int iID = 0;
: bool bVisible = false;
: struct Vector2
: {
: int iX;
: int iY;
: }
: 這種命名法,
常見有二種可能,一種是老人(從turbo C)時代寫下來,習慣改不掉
另一種是跟錯人學,或學錯範例(看錯書?)
: 個人看了真的覺得很痛苦.
: 我的看法是:
: 我們專案使用visual studio, 此情形下若要知道型態滑鼠上去就知道了,
: 並不需要依賴變數前面型別的縮寫.
這樣的論點你一提出來就可能被打槍
是的,大家都用Visual Studio,那又如何,有的人就是喜歡用NotePad++
或是用vim寫code,型別不會跳出來囉
像我喜歡用textmate寫code,純個人習慣
所以就算那是事實,仍是很weak的論點
: 但大家的反應是"有差嗎"或者"習慣了".
其實有的時候真的是這樣
我知道很醜,但我很習慣在加上s或甚至str_去命
尤其是寫python的時候,甚至有時會寫json_str_user
是長了一點,但是接手或debug時很方便
重點是,寫code命名是一種藝術,你有你的論點,別人有別的
有些東西有共識,有些東西沒有,像到底是
UserProfile好還是user_profile好
每個語言甚至傳統都不一樣
: 不過大家也不反對我把一些舊的/共用的class裡面的code重新命名去掉縮寫,
: 所以實際上同事可以接受也沒有閱讀困難,
: 而且也並不真的需要那個縮寫幫助寫作,
: 只是好像不加縮寫不行.
: 而且因為專案並無coding規範,
: 所以光是提出這種命名沒有意義的說詞是沒人鳥的...
我強列推薦這本書
http://www.amazon.com/Art-Readable-Code-Dustin-Boswell/dp/0596802293
我讀完之後才大徹大誤
講白一點,最簡單的原則
命名就是讓後人方便讀懂,關鍵在清楚
在不同的情境,不一定要死守特別的規定
書中舉了很多不同的情境,可能拿來說服別人
大原則是,code是用來給人讀的,怎樣別人好讀,就怎麼寫
命名是一種藝術,關鍵在於,怎樣最Readable
--
※ 發信站: 批踢踢實業坊(ptt.cc)
◆ From: 172.249.69.127
推
05/23 15:29, , 1F
05/23 15:29, 1F
→
05/23 15:30, , 2F
05/23 15:30, 2F
推
05/23 15:39, , 3F
05/23 15:39, 3F
→
05/23 15:40, , 4F
05/23 15:40, 4F
推
05/23 16:26, , 5F
05/23 16:26, 5F
→
05/23 16:39, , 6F
05/23 16:39, 6F
→
05/23 16:42, , 7F
05/23 16:42, 7F
→
05/23 16:43, , 8F
05/23 16:43, 8F
推
05/23 17:03, , 9F
05/23 17:03, 9F
→
05/23 17:03, , 10F
05/23 17:03, 10F
→
05/23 17:04, , 11F
05/23 17:04, 11F
→
05/23 17:04, , 12F
05/23 17:04, 12F
→
05/23 17:35, , 13F
05/23 17:35, 13F
→
05/23 17:36, , 14F
05/23 17:36, 14F
→
05/23 17:51, , 15F
05/23 17:51, 15F
→
05/23 17:52, , 16F
05/23 17:52, 16F
→
05/23 17:55, , 17F
05/23 17:55, 17F
→
05/23 17:56, , 18F
05/23 17:56, 18F
推
05/23 17:58, , 19F
05/23 17:58, 19F
推
05/23 18:03, , 20F
05/23 18:03, 20F
推
05/23 18:08, , 21F
05/23 18:08, 21F
→
05/23 19:41, , 22F
05/23 19:41, 22F
→
05/23 19:42, , 23F
05/23 19:42, 23F
推
05/23 20:04, , 24F
05/23 20:04, 24F
→
05/23 21:39, , 25F
05/23 21:39, 25F
→
05/23 21:40, , 26F
05/23 21:40, 26F
推
05/24 00:58, , 27F
05/24 00:58, 27F
→
05/24 00:58, , 28F
05/24 00:58, 28F
→
05/24 00:59, , 29F
05/24 00:59, 29F
→
05/24 01:14, , 30F
05/24 01:14, 30F
→
05/24 01:21, , 31F
05/24 01:21, 31F
推
05/24 14:00, , 32F
05/24 14:00, 32F
討論串 (同標題文章)