何時使用 camelCase
camelCase 保持第一個 token 小寫,常用於表示值或行為的識別字。
命名慣例指南
兩者都移除分隔符並以大寫表示內部單字邊界。差別是 camelCase 以小寫開頭,PascalCase 以大寫開頭。
| 差異 | camelCase | PascalCase |
|---|---|---|
| 範例 | userProfileImage | UserProfileImage |
| 常見用途 | variable、property、parameter、function、object field | class、type、component、constructor、model |
| 第一個字元 | 小寫 | 大寫 |
| 單字分隔符 | 無 | 無 |
| 後續單字 | 首字母大寫 | 首字母大寫 |
| 典型角色 | 值或行為 | type 或 component |
camelCase 保持第一個 token 小寫,常用於表示值或行為的識別字。
PascalCase 連第一個 token 也大寫,常用來視覺區分 type、class、component。
| 情境 | 建議格式 | 原因 |
|---|---|---|
| variable、parameter 與一般 function | camelCase | 在許多 JavaScript / Java 風格 codebase 中,lower camel case 常用來表示值與行為。 |
| class、type、component、constructor | PascalCase | Upper camel case 能讓 type 類名稱和一般值更容易從視覺上區分。 |
| 自動產生的 SDK / schema code | 遵循 generator 或 schema 規則 | 手動改 case 可能破壞產生的 reference,也會讓日後重新產生的 diff 更難比較。 |
| 公開 package / framework API | 遵循 ecosystem 慣例 | 對使用者來說,熟悉的命名方式通常比專案自訂偏好更容易理解。 |
依識別字語意角色選擇,並遵循專案既有慣例,特別是縮寫寫法。
貼上識別字即可查看目標格式與支援的開發者命名風格。轉換會在瀏覽器本機執行。
UserProfileImageUrl
userProfileImageUrlUserProfileImageUrluser_profile_image_urluser-profile-image-urlUSER_PROFILE_IMAGE_URLuser.profile.image.urluser/profile/image/url轉換會在瀏覽器本機執行,輸入不會傳送到轉換伺服器。