รูปแบบตัวอักษร: คู่มือฉบับสมบูรณ์
รูปแบบตัวอักษรเป็นแบบแผนสำหรับการเขียนตัวระบุหลายคำในการเขียนโปรแกรม แต่ละภาษาและชุมชนมีการตั้งค่าสำหรับชื่อตัวแปร ฟังก์ชัน และค่าคงที่ การเข้าใจและการใช้รูปแบบที่ถูกต้องทำให้โค้ดของคุณอ่านได้ง่ายและเป็นไปตามแบบแผนของชุมชน คู่มือนี้อธิบายรูปแบบตัวอักษรทั่วไป กฎของพวกมัน และเมื่อไหร่ควรใช้แต่ละรูปแบบ
รูปแบบตัวอักษรทั่วไป
camelCase: คำแรกตัวพิมพ์เล็ก คำที่ตามมาขึ้นต้นด้วยตัวพิมพ์ใหญ่ ตัวอย่าง: firstName, getUserData, isValidEmail ใช้ใน: JavaScript/TypeScript (ตัวแปรและฟังก์ชัน), Java (ตัวแปรและเมธอด), C# (ตัวแปรท้องถิ่น) PascalCase (UpperCamelCase): ทุกคำขึ้นต้นด้วยตัวพิมพ์ใหญ่ ตัวอย่าง: FirstName, UserProfile, DatabaseConnection ใช้ใน: JavaScript/TypeScript (คลาสและคอมโพเนนต์), Java (คลาส), C# (คลาส, เมธอด, คุณสมบัติ), Python (คลาส) snake_case: คำทั้งหมดตัวพิมพ์เล็ก คั่นด้วยขีดล่าง ตัวอย่าง: first_name, get_user_data, is_valid_email ใช้ใน: Python (ตัวแปรและฟังก์ชัน), Ruby (ตัวแปรและเมธอด), PHP (ตัวแปร), SQL (ชื่อตารางและคอลัมน์) SCREAMING_SNAKE_CASE: คำทั้งหมดตัวพิมพ์ใหญ่ คั่นด้วยขีดล่าง ตัวอย่าง: MAX_SIZE, API_KEY, DATABASE_URL ใช้ใน: ค่าคงที่ในภาษาส่วนใหญ่, ตัวแปรสภาพแวดล้อม, ค่ากำหนดค่า kebab-case (dash-case): คำทั้งหมดตัวพิมพ์เล็ก คั่นด้วยขีดกลาง ตัวอย่าง: first-name, user-profile, background-color ใช้ใน: HTML (แอตทริบิวต์), CSS (คลาสและตัวระบุ), URL (slug), ชื่อไฟล์
การเลือกรูปแบบที่ถูกต้อง
JavaScript/TypeScript: ตัวแปรและฟังก์ชัน: camelCase (firstName, getUserData) คลาสและคอมโพเนนต์: PascalCase (UserProfile, NavBar) ค่าคงที่: SCREAMING_SNAKE_CASE (MAX_RETRY_COUNT) ไฟล์: kebab-case สำหรับคอมโพเนนต์ (user-profile.tsx) หรือ camelCase (userProfile.ts) Python: ตัวแปร ฟังก์ชัน และเมธอด: snake_case (first_name, get_user_data) คลาส: PascalCase (UserProfile, DatabaseConnection) ค่าคงที่: SCREAMING_SNAKE_CASE (MAX_RETRY_COUNT) โมดูล: snake_case (user_profile.py) Java: ตัวแปรและเมธอด: camelCase (firstName, getUserData) คลาส: PascalCase (UserProfile, DatabaseConnection) ค่าคงที่: SCREAMING_SNAKE_CASE (MAX_RETRY_COUNT) แพ็คเกจ: ตัวพิมพ์เล็กทั้งหมด ไม่มีขีดล่าง (com.example.userprofile) CSS/HTML: คลาส CSS: kebab-case (btn-primary, user-profile-card) แอตทริบิวต์ HTML: kebab-case (data-user-id, aria-label) JavaScript camelCase แปลงเป็น kebab-case ใน HTML (backgroundColor → background-color) SQL: ตาราง: snake_case หรือ camelCase (user_profiles หรือ userProfiles) คอลัมน์: snake_case (first_name, created_at) แนวทางปฏิบัติที่แนะนำ: snake_case สำหรับความเข้ากันได้ที่ดีกว่า
แนวปฏิบัติที่ดีที่สุด
มีความสม่ำเสมอ: เลือกรูปแบบและยึดติดกับมันตลอดทั้งโครงการของคุณ ทีมทั้งหมดควรใช้แบบแผนเดียวกัน ใช้ linter (ESLint, Prettier) เพื่อบังคับให้มีความสม่ำเสมอ จัดทำเอกสารแบบแผนของคุณในคู่มือสไตล์ของโครงการ ปฏิบัติตามแบบแผนของภาษา: ทุกภาษามีแบบแผนที่ยอมรับ—เรียนรู้และปฏิบัติตามพวกมัน อย่าเขียน snake_case ใน JavaScript หรือ camelCase ใน Python (สำหรับตัวแปร) โค้ดที่เป็นไปตามแบบแผนอ่านง่ายสำหรับนักพัฒนาคนอื่น ใช้ชื่อที่มีความหมาย: รูปแบบไม่แทนที่ชื่อที่ชัดเจน ดี: getUserProfile(), calculateTotalPrice() ไม่ดี: gup(), ctp() ชื่อที่มีความหมายด้วยรูปแบบที่เหมาะสม = โค้ดที่ดีที่สุด เครื่องมืออัตโนมัติ: ใช้เครื่องมือของเราหรือฟังก์ชันไลบรารี สำหรับการแปลง JavaScript: lodash (_.camelCase, _.snakeCase, _.kebabCase) Python: stringcase หรือ inflection อย่าเขียนฟังก์ชันการแปลงด้วยมือ—มีข้อผิดพลาดบ่อย กรณีพิเศษ: ตัวย่อ: HTML, API, URL → รักษาตัวพิมพ์ใหญ่หรือปฏิบัติเหมือนคำ camelCase: htmlParser หรือ HtmlParser (ทั้งสองยอมรับได้, มีความสม่ำเสมอ) PascalCase: HTMLParser หรือ HtmlParser ตัวเลข: ตัวเลขสามารถปรากฏได้ (user2Profile, base64Encode) อ่านไล่ตัวอักษรเดียว: หลีกเลี่ยงชื่อตัวอักษรเดียวยกเว้นตัวนับลูป (i, j, k)
ลองใช้เครื่องมือ
แปลงตัวพิมพ์
เรียนรู้เพิ่มเติม
คำถามที่พบบ่อย
แปลงตัวพิมพ์
คำถามที่พบบ่อย →