Why is it hard to name a class, a method or a variable? — Kamil Lelonek personal blog — Medium | 程式設計

2 則討論 IngramChen 張貼於 9 years ago

IngramChen 積分 0

最後一個例子，我傾向用 comment 來寫，而不是用特別長的變數名來解釋。命名到這麼長表示有一些 know how 藏在細節裡 (business 相關)，多解釋一點比較好吧？自己一個月後也才看的懂。

可以的話，還會在 comment 裡加上數學公式或來源解釋 (通常是 wiki page or stackoverflow page)。

但基本上作者說的沒錯就是。而且，也不能因為有了 comment 後，變數就可以隨便的命名。

回應 9 years ago

zwlin 積分 0

讀別人的 code 簡直的黑暗深淵。

像作者說的，透過「好的」變數命名去寫程式、「說故事」，才是讓其它人理解自己的 code 的好手段。

還好現在的 IDE 或開發環境，自己補完的功能都滿強的。不然光敲變數就崩潰了吧。

回應 9 years ago

Kmark 是一個類似 Markdown 語法的格式，以下為提供的功能:

種類	語法	呈現
斜體	兩邊加單星	兩邊加單星
粗體	兩邊加雙星	兩邊加雙星
刪除線	~~兩邊加雙曲號~~	~~兩邊加雙曲號~~
引用	> 左邊加個大於符號	左邊加個大於符號
列表	* 可用星號 * 也可以 - 減號 * 數字加點也可以	可用星號也可以 - 減號數字加點也可以
固定寬字	`abcdefghijk` 兩邊用倒引號包住	`abcdefghijk`
編碼區塊	``` function abc() ``` 上下都用三個倒引號包住	`function abc()`
連結	[這是連結][1] [1]: http://example.com 連結第一部份是文字，先用中括號包住，後面再加上 [編號]。第二部份是連結本身，放在文末，開頭是 [編號]: http	這是連結1 1 http://example.com

Kmark 是一個類似 Markdown 語法的格式，以下為提供的功能:

種類	語法	呈現
斜體	兩邊加單星	兩邊加單星
粗體	兩邊加雙星	兩邊加雙星
刪除線	~~兩邊加雙曲號~~	~~兩邊加雙曲號~~
引用	> 左邊加個大於符號	左邊加個大於符號
列表	* 可用星號 * 也可以 - 減號 * 數字加點也可以	可用星號也可以 - 減號數字加點也可以
固定寬字	`abcdefghijk` 兩邊用倒引號包住	`abcdefghijk`
編碼區塊	``` function abc() ``` 上下都用三個倒引號包住	`function abc()`
連結	[這是連結][1] [1]: http://example.com 連結第一部份是文字，先用中括號包住，後面再加上 [編號]。第二部份是連結本身，放在文末，開頭是 [編號]: http	這是連結1 1 http://example.com