14,727
edits
Coding habits to avoid: Difference between revisions
Jump to navigation
Jump to search
m
no edit summary
(Created page with "避免的 coding 習慣 * 避免使用簡化的的變數名稱，例如 $sd 或 $d 也許一開始還會記得，但是過一陣子就會忘記這是什麼 * 避免使用過於籠統的變數名稱，例如 $data 或 $file_path 「這個 $data 裡面放的是什麼？」當變數名稱不夠明確時，三個月後連自己都會忘記當初的設計。使用具描述性的變數名稱，可以讓程式碼自我說明，減少日後維護的困擾。 ** $data 可能代...") |
mNo edit summary |
||
| Line 4: | Line 4: | ||
* 避免使用過於籠統的變數名稱，例如 $data 或 $file_path 「這個 $data 裡面放的是什麼？」當變數名稱不夠明確時，三個月後連自己都會忘記當初的設計。使用具描述性的變數名稱，可以讓程式碼自我說明，減少日後維護的困擾。 | * 避免使用過於籠統的變數名稱，例如 $data 或 $file_path 「這個 $data 裡面放的是什麼？」當變數名稱不夠明確時，三個月後連自己都會忘記當初的設計。使用具描述性的變數名稱，可以讓程式碼自我說明，減少日後維護的困擾。 | ||
** $data 可能代表任何資料，過一陣子就會忘記裡面存的是什麼內容。建議改成更具體的名稱，例如: (1) $user_data：使用者資料、(2) $order_list：訂單清單、(3) | ** $data 可能代表任何資料，過一陣子就會忘記裡面存的是什麼內容。建議改成更具體的名稱，例如: (1) $user_data：使用者資料、(2) $order_list：訂單清單、(3) $product_info：產品資訊 | ||
** $file_path 建議改成能表達檔案用途的名稱，例如: (1) $config_file_path：設定檔路徑、(2) $upload_image_path：上傳圖片路徑 | ** $file_path 建議改成能表達檔案用途的名稱，例如: (1) $config_file_path：設定檔路徑、(2) $upload_image_path：上傳圖片路徑 | ||