Chuyển đổi chữ hoa chữ thường - Hướng dẫn đầy đủ | DevTools.at

Các kiểu viết hoa phổ biến

Lập trình viên sử dụng nhiều quy ước viết hoa khác nhau, mỗi quy ước phục vụ các mục đích cụ thể và ngữ cảnh. Hiểu các kiểu này và biết khi nào sử dụng chúng là cần thiết cho code chuyên nghiệp. camelCase bắt đầu bằng chữ thường và viết hoa từ đầu tiên của mỗi từ tiếp theo: myVariableName, getUserData, calculateTotalPrice. Đây là quy ước tiêu chuẩn cho tên biến và hàm trong JavaScript, Java, C#, và nhiều ngôn ngữ khác. Quy ước này làm cho các định danh nhiều từ dễ đọc mà không cần dấu cách hoặc dấu gạch dưới. PascalCase (còn được gọi là UpperCamelCase) viết hoa ký tự đầu tiên của mỗi từ bao gồm từ đầu tiên: MyClassName, UserProfile, DatabaseConnection. Quy ước này được sử dụng cho tên lớp trong hầu hết các ngôn ngữ lập trình hướng đối tượng, tên component trong React, và các loại trong TypeScript. Viết hoa đầu tiên phân biệt lớp với biến. snake_case sử dụng dấu gạch dưới để phân tách các từ, tất cả chữ thường: my_variable_name, get_user_data, calculate_total_price. Python ưu tiên snake_case cho tên hàm và biến. Nó cũng phổ biến trong Ruby, Rust, và cho tên cơ sở dữ liệu trong nhiều SQL dialects. Dấu gạch dưới làm cho các từ dễ đọc trong các tên dài. SCREAMING_SNAKE_CASE sử dụng chữ hoa với dấu gạch dưới: MAX_SIZE, API_KEY, DATABASE_URL. Quy ước này gần như phổ quát cho hằng số và biến môi trường. Chữ hoa thu hút sự chú ý và báo hiệu rằng giá trị không nên thay đổi. Hầu hết các ngôn ngữ sử dụng này cho hằng số. kebab-case sử dụng gạch nối để phân tách các từ, tất cả chữ thường: my-variable-name, user-profile, api-endpoint. Kiểu này phổ biến trong URL (example.com/user-profile), tên file CSS, và thuộc tính HTML. Gạch nối thân thiện với URL và tạo các slug có thể đọc được. Tránh kebab-case trong hầu hết các ngôn ngữ lập trình vì gạch nối trông giống như toán tử trừ. UPPER CASE sử dụng chữ hoa cho tất cả ký tự: MYTEXT, USER DATA, CALCULATE. Chủ yếu được sử dụng cho hằng số có từ đơn hoặc khi muốn nhấn mạnh mạnh mẽ. Kém phổ biến hơn so với SCREAMING_SNAKE_CASE cho hằng số trong lập trình hiện đại. lower case sử dụng chữ thường cho tất cả ký tự: mytext, userdata, calculate. Hiếm trong lập trình hiện đại cho các định danh nhiều từ vì thiếu phân tách từ làm cho chúng khó đọc. Chủ yếu thấy trong các biến tên đơn ngắn. Title Case viết hoa từ đầu tiên của mỗi từ: My Variable Name, User Profile Data. Hiếm trong lập trình nhưng phổ biến cho tiêu đề giao diện người dùng, tên tài liệu, và nhãn. Không được sử dụng cho định danh code vì khoảng trắng.

Chọn kiểu phù hợp

Chọn quy ước viết hoa phù hợp phụ thuộc vào ngữ cảnh, ngôn ngữ lập trình, và các tiêu chuẩn của nhóm. Tuân theo các quy ước đã thiết lập của ngôn ngữ bạn sử dụng. JavaScript sử dụng camelCase cho biến và hàm, PascalCase cho lớp. Python sử dụng snake_case cho hầu hết mọi thứ. Java sử dụng camelCase cho phương thức, PascalCase cho lớp. C# tuân theo các quy ước tương tự như Java. Đối với hằng số, sử dụng SCREAMING_SNAKE_CASE gần như phổ quát trên các ngôn ngữ. Điều này làm cho hằng số nổi bật ngay lập tức trong code: const MAX_RETRIES = 3, final int DEFAULT_TIMEOUT = 5000. Quy ước làm rõ rằng các giá trị này không nên thay đổi trong quá trình thực thi. Tên cơ sở dữ liệu thường sử dụng snake_case. Tên bảng như user_profiles, order_items, product_categories dễ đọc và hoạt động trên tất cả các hệ thống cơ sở dữ liệu. Một số nhóm ưu tiên PascalCase cho bảng (UserProfiles) nhưng snake_case phổ biến hơn, đặc biệt là trong PostgreSQL và các cơ sở dữ liệu mã nguồn mở. URL và định tuyến web nên sử dụng kebab-case. Chuẩn URL example.com/user-profiles/edit-profile dễ đọc và thân thiện với SEO. Gạch nối được coi là phân tách từ bởi công cụ tìm kiếm, trong khi dấu gạch dưới không phải như vậy. Tránh camelCase trong URL—example.com/userProfiles trông không chuyên nghiệp và có thể gây ra vấn đề nhạy cảm chữ hoa. Tên file tuân theo các quy ước khác nhau theo ngữ cảnh. Code JavaScript thường sử dụng camelCase (userProfile.js) hoặc kebab-case (user-profile.js). Component React thường sử dụng PascalCase (UserProfile.jsx). File Python sử dụng snake_case (user_profile.py). File CSS sử dụng kebab-case (user-profile.css). Hình ảnh và tài sản thường sử dụng kebab-case hoặc snake_case. API endpoint nên nhất quán trong cơ sở code của bạn. RESTful API thường sử dụng kebab-case: /api/user-profiles, /api/order-items. Một số nhóm ưu tiên snake_case: /api/user_profiles. GraphQL thường sử dụng camelCase: getUserProfile, createOrderItem. Chọn một quy ước và tuân theo nó một cách nhất quán. Biến môi trường gần như luôn sử dụng SCREAMING_SNAKE_CASE: DATABASE_URL, API_KEY, MAX_UPLOAD_SIZE. Quy ước này phổ quát trên các nền tảng và framework. Nó làm cho biến môi trường dễ phân biệt với các biến thông thường trong code. Đối với cấu hình JSON và YAML, camelCase là phổ biến nhất trong cộng đồng JavaScript (package.json, tsconfig.json) trong khi snake_case phổ biến hơn trong cộng đồng Python và Ruby. Một lần nữa, sự nhất quán trong dự án của bạn quan trọng hơn lựa chọn cụ thể.

Thực hành tốt nhất

Sự nhất quán quan trọng hơn sở thích cá nhân. Nếu cơ sở code của bạn sử dụng camelCase, tiếp tục sử dụng camelCase ngay cả khi bạn thích snake_case. Trộn lẫn các quy ước làm cho code khó đọc và chuyên nghiệp hơn. Hầu hết các nhóm ghi lại các tiêu chuẩn mã hóa của họ để tất cả mọi người tuân theo cùng các quy ước. Sử dụng linter và formatter để thi hành các quy ước. ESLint cho JavaScript, Pylint cho Python, và các công cụ tương tự có thể tự động kiểm tra và sửa các vấn đề viết hoa. Prettier có thể tự động định dạng code để khớp với các quy ước của nhóm bạn. Tự động hóa này ngăn chặn các cuộc tranh luận và đảm bảo sự nhất quán. Tên biến nên mô tả, không phải ngắn gọn. getUserProfileData tốt hơn usrPD. Công cụ hiện đại tự động hoàn thành các tên dài, vì vậy gõ không phải là mối quan tâm. Code có thể đọc được quan trọng hơn code ngắn gọn. Biến tên một chữ cái (i, j, x) chỉ chấp nhận được cho biến vòng lặp và toán học. Tránh từ viết tắt trừ khi chúng được biết đến rộng rãi. API, URL, HTTP, ID là chấp nhận được vì chúng phổ biến. Nhưng usrPrf (user profile) hoặc calcTtl (calculate total) làm cho code khó hiểu. Khi sử dụng từ viết tắt, hãy nhất quán: userId hay userID? httpRequest hay HTTPRequest? Chọn một quy ước và gắn bó với nó. Cẩn thận với độ dài. Trong khi tên mô tả là tốt, calculateUserProfileDataAndReturnFormattedResult là quá dài. Nhắm đến 2-4 từ cho hầu hết các định danh. getUserProfile cân bằng tốt giữa sự rõ ràng và tính ngắn gọn. Nếu bạn cần nhiều từ hơn, hãy xem xét liệu hàm hoặc lớp của bạn đang làm quá nhiều—có thể nên chia nó. Đối với Boolean, sử dụng tiền tố như is, has, should, can: isActive, hasPermission, shouldUpdate, canDelete. Điều này làm cho Boolean dễ nhận ra ngay lập tức và cải thiện khả năng đọc trong các điều kiện: if (isActive) rõ ràng hơn if (active). Nhóm các hằng số và cấu hình liên quan. Thay vì MAX_RETRIES, MAX_TIMEOUT, MAX_SIZE rải rác trong code, hãy xem xét nhóm chúng: CONFIG.MAX_RETRIES, LIMITS.MAX_UPLOAD_SIZE. Điều này làm cho các hằng số dễ tìm và duy trì hơn. Khi chuyển đổi giữa các quy ước (ví dụ, từ API snake_case sang code camelCase), hãy làm điều đó ở ranh giới. Chuyển đổi khi dữ liệu vào hoặc ra khỏi ứng dụng của bạn, không phải xuyên suốt code. Điều này duy trì sự nhất quán trong cơ sở code của bạn trong khi vẫn tương thích với các hệ thống bên ngoài. Ghi lại các quy tắc đặt tên của nhóm bạn trong hướng dẫn đóng góp hoặc tài liệu code. Bao gồm ví dụ về cách đặt tên biến, hàm, lớp, file, và các loại định danh khác. Tài liệu này giúp các thành viên mới trong nhóm tuân theo các quy ước ngay từ đầu. Xem xét khán giả. Code API công khai có thể cần tuân theo các quy ước khác nhau so với code nội bộ. Nếu thư viện của bạn được sử dụng bởi JavaScript, Python, và nhà phát triển Ruby, hãy xem xét cung cấp các API ngôn ngữ cụ thể phù hợp với quy ước của mỗi cộng đồng.

Hướng dẫn chuyển đổi chữ hoa chữ thường

Các kiểu viết hoa phổ biến

Chọn kiểu phù hợp

Thực hành tốt nhất

Thử công cụ

Tìm hiểu thêm

camelCase so với snake_case

Câu hỏi thường gặp