Hướng dẫn độ dài tên biến & hàm - Quy ước đặt tên trong lập trình

9 phút đọc

Trong lập trình, việc đặt tên là một trong những yếu tố quan trọng nhất ảnh hưởng đến khả năng đọc mã nguồn. Tên quá ngắn không truyền đạt được ý nghĩa; tên quá dài khiến mã nguồn trở nên rườm rà. Việc chọn độ dài phù hợp đòi hỏi sự đánh giá dựa trên phạm vi và độ phức tạp. Bài viết này đề cập đến hướng dẫn về độ dài đặt tên và quy ước riêng cho từng ngôn ngữ. Để tìm hiểu thêm, hãy xem sách về thực hành clean code. Kiểm tra độ dài định danh của bạn với Bộ đếm ký tự.

Độ dài tên biến theo phạm vi

Độ dài phù hợp của tên biến tỷ lệ thuận với phạm vi của nó. Nguyên tắc này được ủng hộ rộng rãi trong cuốn "Clean Code" của Robert C. Martin và các hướng dẫn phong cách của Google. Lý do bắt nguồn từ tâm lý học nhận thức: bộ nhớ làm việc của con người chỉ có thể giữ đồng thời 4–7 khối thông tin. Đối với biến có phạm vi rộng, bản thân tên phải khôi phục được ý nghĩa mà không cần ngữ cảnh xung quanh. Ngược lại, trong vòng lặp 2–3 dòng, ngữ cảnh đóng vai trò như một khối thông tin, nên tên ngắn như i giúp giảm tải nhận thức.

Phạm vi	Độ dài khuyến nghị	Ví dụ	Lý do
Bộ đếm vòng lặp (1–3 dòng)	1–2 ký tự	`i`, `j`, `k`	Quy ước được hiểu rộng rãi
Lambda / khối ngắn (≤5 dòng)	3–8 ký tự	`item`, `user`, `val`	Ngữ cảnh làm rõ kiểu/vai trò
Biến cục bộ trong hàm	8–15 ký tự	`userName`, `totalPrice`	Vai trò phải rõ ràng trong phạm vi hàm
Trường/thuộc tính của lớp	10–20 ký tự	`maxRetryCount`, `isAuthenticated`	Được tham chiếu trong toàn bộ lớp
Biến toàn cục / hằng số	15–25 ký tự	`MAX_CONNECTION_TIMEOUT`, `DEFAULT_PAGE_SIZE`	Phải rõ ràng trong toàn bộ mã nguồn

Phân tích độ dài đặt tên của các dự án OSS lớn

Độ dài định danh trong các dự án mã nguồn mở thực tế trông như thế nào? Phân tích mã nguồn từ các dự án lớn cho thấy sự khác biệt rõ ràng về độ dài đặt tên tùy thuộc vào ngôn ngữ và tính chất dự án.

Dự án	Ngôn ngữ	Độ dài biến TB	Độ dài hàm TB	Đặc điểm
Linux Kernel	C	~6 ký tự	~12 ký tự	Biến ngắn; tên hàm dài hơn do tiền tố module
Spring Framework	Java	~12 ký tự	~18 ký tự	Đặt tên mô tả kỹ lưỡng; nhìn chung dài
CPython	Python	~8 ký tự	~14 ký tự	Bao gồm dấu gạch dưới phân tách từ snake_case
React	JavaScript	~9 ký tự	~15 ký tự	Tên component thường dài; biến nội bộ ngắn
Kubernetes	Go	~7 ký tự	~13 ký tự	Phản ánh văn hóa ngắn gọn của Go
Ruby on Rails	Ruby	~9 ký tự	~15 ký tự	Tên phương thức kiểu DSL gần với ngôn ngữ tự nhiên

Một mẫu đáng chú ý là các dự án C có tên biến ngắn, nhưng tên hàm bao gồm tiền tố module (tcp_v4_connect, ext4_read_inode) khiến chúng tương đối dài. Trong C, vốn không có namespace, tiền tố đóng vai trò thay thế namespace. Ngược lại, Spring Framework của Java chuẩn hóa tên dài với việc tự động hoàn thành của IDE là điều hiển nhiên — tên lớp vượt quá 50 ký tự như AbstractTransactionalDataSourceSpringContextTests không phải là hiếm.

Hướng dẫn tên hàm và lớp

Loại định danh	Độ dài khuyến nghị	Nguyên tắc đặt tên	Ví dụ
Tên hàm	10–25 ký tự	Định dạng động từ + đối tượng	`calculateTotalPrice`, `sendEmailNotification`
Tên lớp	10–25 ký tự	Danh từ hoặc cụm danh từ	`UserRepository`, `PaymentProcessor`
Tên interface	10–25 ký tự	Tính từ hoặc danh từ mô tả hành vi	`Serializable`, `EventListener`
Tên hằng số	10–30 ký tự	UPPER_SNAKE_CASE với ý nghĩa cụ thể	`MAX_RETRY_COUNT`, `DEFAULT_TIMEOUT_MS`
Biến/hàm Boolean	10–20 ký tự	Tiền tố is/has/can/should	`isValid`, `hasPermission`, `canExecute`

Hàm nên luôn bắt đầu bằng một động từ. fetchData() rõ ràng hơn data(); validateInput() tốt hơn validation().

Quy ước riêng theo ngôn ngữ

Ngôn ngữ	Biến/Hàm	Lớp	Hằng số	Hướng dẫn phong cách
Java	camelCase	PascalCase	UPPER_SNAKE_CASE	Google Java Style Guide
Python	snake_case	PascalCase	UPPER_SNAKE_CASE	PEP 8
JavaScript	camelCase	PascalCase	UPPER_SNAKE_CASE	Airbnb Style Guide
Go	camelCase / PascalCase	PascalCase	PascalCase	Effective Go
Ruby	snake_case	PascalCase	UPPER_SNAKE_CASE	Ruby Style Guide
C#	camelCase / PascalCase	PascalCase	PascalCase	Microsoft C# Conventions

Java — Tên dài được chấp nhận trong văn hóa lập trình. Với tính năng tự động hoàn thành phong phú của IDE, những tên như AbstractSingletonProxyFactoryBean được sử dụng trên thực tế. Thống kê của IntelliJ IDEA cho thấy khoảng 40% thao tác gõ phím của lập trình viên Java đến từ tự động hoàn thành, giảm thiểu tác động năng suất của tên dài.
Python — PEP 8 ưu tiên sự ngắn gọn. snake_case làm rõ ranh giới từ, mặc dù thêm một ký tự cho mỗi từ so với camelCase: get_user_name (13 ký tự) so với getUserName (11 ký tự).
JavaScript — Phát triển frontend có xu hướng dùng tên component dài. Những tên như UserProfileEditForm làm rõ vai trò được ưu tiên.
Go — Như nhà thiết kế ngôn ngữ Rob Pike đã nói, "tên dài không che giấu được sự phức tạp." Cộng đồng Go rất ưa chuộng đặt tên ngắn gọn. Biến receiver sử dụng 1–2 ký tự (s cho server, c cho client) theo quy ước, nhất quán với cơ chế export chữ hoa/chữ thường của Go.

IDE Autocomplete và độ dài tên

Mối lo ngại rằng "tên dài gõ mệt" phần lớn đã được loại bỏ bởi các IDE hiện đại. So sánh tính năng tự động hoàn thành giữa các IDE chính cho thấy độ dài tên có tác động tối thiểu đến tốc độ phát triển.

IDE / Trình soạn thảo	Kích hoạt hoàn thành	Chiến lược khớp	Hỗ trợ tên dài
IntelliJ IDEA	Tự động khi gõ	Khớp chữ cái đầu CamelCase (`gUN` → `getUserName`)	2–3 chữ cái đầu thu hẹp ứng viên; tên dài tốn ít công sức
VS Code	Tự động khi gõ	Khớp mờ (`usrnm` → `userName`)	Hiển thị khớp một phần; không cần gõ chính xác
Vim / Neovim (LSP)	Ctrl+N hoặc tích hợp LSP	Hoàn thành dựa trên LSP nhận biết kiểu	Hoàn thành tương đương IDE qua coc.nvim hoặc nvim-cmp

Tính năng khớp CamelCase của IntelliJ IDEA đặc biệt mạnh mẽ — chỉ cần gõ ACTDSCT là hoàn thành thành AbstractConcurrentTransactionalDataSourceSpringContextTests. Điều này có nghĩa là độ dài tên không cần bị giới hạn bởi công sức gõ; bạn có thể chọn độ dài tối ưu hoàn toàn vì mục đích dễ đọc.

Thông tin thú vị về đặt tên

Hướng dẫn phong cách mã nguồn Linux kernel ưu tiên tên biến ngắn. Chính Linus Torvalds đã tuyên bố rằng biến vòng lặp nên dùng i thay vì loop_counter. Ngược lại, hướng dẫn phong cách Java của Google không khuyến khích tên một ký tự ngoài bộ đếm vòng lặp và tham số lambda. Sự tương phản này phản ánh các bối cảnh khác nhau: mã kernel được đọc bởi một nhóm nhỏ chuyên gia so với dịch vụ web quy mô lớn được đọc bởi nhiều lập trình viên. Các nghiên cứu về dự án mã nguồn mở trên GitHub cho thấy độ dài trung bình của tên biến là khoảng 8,5 ký tự.

Vấn đề với tên quá dài và quá ngắn

Lỗi đặt tên rơi vào hai thái cực: quá ngắn để truyền đạt ý nghĩa, và quá dài để đọc thoải mái. Những tên ngắn như d, tmp, hoặc val ngoài bộ đếm vòng lặp trở nên khó hiểu chỉ trong vài ngày — ngay cả với chính tác giả.

Tên quá dài cũng gây vấn đề tương tự. Một biến như numberOfItemsInTheShoppingCartBeforeDiscount không vừa trên một dòng và thực sự làm giảm khả năng đọc. Điểm cân bằng lý tưởng là một tên truyền đạt vai trò của nó trong nháy mắt mà không làm gián đoạn luồng mã xung quanh.

Từ góc độ khoa học nhận thức, mối quan hệ giữa độ dài định danh và tốc độ đọc tuân theo đường cong hình chữ U. Tên quá ngắn gây chi phí nhận thức cho "tái tạo ý nghĩa," trong khi tên quá dài gây chi phí cho "quét thị giác." Nghiên cứu cho thấy các định danh tiếng Anh trong khoảng 8–20 ký tự đạt hiệu quả đọc cao nhất. Điều này xuất phát từ sự cân bằng giữa độ dài chuỗi mà thị giác con người có thể nhận diện cùng lúc (~7–10 ký tự) và số từ tối thiểu cần thiết để truyền đạt ý nghĩa (2–3 từ).

Tên biến Unicode và Multibyte

Nhiều ngôn ngữ lập trình hỗ trợ định danh Unicode, nhưng việc sử dụng ký tự không phải ASCII trong tên biến gây ra một số cạm bẫy trên thực tế.

Ngôn ngữ	Biến Unicode	Ví dụ	Lưu ý
Python 3	Hỗ trợ đầy đủ	`名前 = "Taro"`	PEP 8 khuyến nghị chỉ dùng ASCII; tránh trong nhóm quốc tế
Ruby	Hỗ trợ đầy đủ	`数値 = 42`	Cần magic comment `# encoding: utf-8` (trước Ruby 2.0)
JavaScript	Cho phép Unicode escape	`let café = true`	Chuẩn hóa NFC/NFD có thể khiến tên trông giống nhau nhưng khác nhau
Java	Hỗ trợ đầy đủ	`int 金額 = 1000;`	Biên dịch được, nhưng hầu hết hướng dẫn phong cách không khuyến khích
Go	Danh mục Unicode Letter	`名前 := "Taro"`	Chỉ cho phép ký tự thuộc danh mục Letter của Unicode
C / C++	Hạn chế (C11/C++11+)	`int données = 0;`	Hỗ trợ khác nhau tùy trình biên dịch

Vấn đề chuẩn hóa Unicode của JavaScript đáng được chú ý đặc biệt. Tên biến café có thể được biểu diễn theo hai cách: dạng NFC với é là một ký tự đơn (U+00E9), hoặc dạng NFD với e + dấu kết hợp (U+0065 U+0301). Chúng trông giống hệt nhau nhưng được xử lý như các định danh khác nhau. Vì hệ thống tệp của macOS (APFS) sử dụng NFD, các lỗi không mong muốn có thể xảy ra khi tạo tên biến từ tên tệp.

Xung đột từ khóa dành riêng là một trường hợp biên thường bị bỏ qua. Trong Python, class, import, và return là từ khóa dành riêng, nhưng các cách giải quyết như cls (viết tắt của class) và klass đã trở thành quy ước phổ biến. Trong JavaScript, class trở thành từ khóa dành riêng trong ES6, gây ra lỗi cú pháp trong mã trước ES6 sử dụng nó làm tên biến — một vấn đề di chuyển thực tế.

Các lỗi thường gặp

Viết tắt quá mức — Những tên như usrAccMgr hoặc cntDwnTmr khó hiểu với bất kỳ ai ngoài tác giả. Hạn chế viết tắt chỉ với những từ được công nhận rộng rãi (URL, HTTP, ID).
Lạm dụng ký pháp Hungary — Thêm tiền tố thông tin kiểu như strName hoặc intAge là thừa trong các IDE hiện đại với suy luận kiểu và tooltip khi di chuột. Chính Microsoft cũng không khuyến khích ký pháp Hungary trong C#.
Đặt tên không nhất quán trong dự án — Trộn lẫn user_name, userName, và UserName cho cùng một khái niệm phá hủy khả năng tìm kiếm. Thiết lập hướng dẫn phong cách ngay từ đầu dự án và thực thi bằng linter.

Kỹ thuật đặt tên chuyên nghiệp

Xem xét đặt tên trong code review — Kiểm tra không chỉ tính đúng đắn của logic mà còn xem tên có truyền đạt ý định hay không. Cải thiện đặt tên là một trong những đầu tư có ROI cao nhất cho chất lượng mã dài hạn.
Sử dụng tính năng đổi tên của IDE — Khi bạn nghĩ ra tên tốt hơn, hãy dùng tính năng đổi tên của IDE (IntelliJ Shift+F6, VS Code F2) để cập nhật an toàn tất cả tham chiếu.
Duy trì bảng thuật ngữ nhóm — Quyết định xem "user," "account," hay "member" đại diện cho một khái niệm nhất định và ghi lại. Điều này phù hợp với nguyên tắc "ngôn ngữ chung" của Domain-Driven Design. Khám phá hướng dẫn phương pháp tốt nhất trong kỹ thuật phần mềm để tìm hiểu thêm về chủ đề này

Thực thi quy ước đặt tên bằng Linters

Để thống nhất quy ước đặt tên trong nhóm, kiểm tra tự động bằng linter là thiết yếu. Dưới đây là các linter chính và quy tắc liên quan đến đặt tên cho từng ngôn ngữ.

Ngôn ngữ	Linter	Quy tắc đặt tên	Ví dụ cấu hình
JavaScript / TypeScript	ESLint	`@typescript-eslint/naming-convention`	Bắt buộc camelCase cho biến, UPPER_CASE cho hằng số, PascalCase cho kiểu
Python	pylint / Ruff	`C0103` (invalid-name)	Bắt buộc snake_case; đặt độ dài tối thiểu (mặc định: 2 ký tự)
Java	Checkstyle	`MemberName`, `MethodName`	Định nghĩa quy tắc đặt tên qua mẫu regex
Go	golangci-lint	`revive`'s `var-naming`	Bắt buộc MixedCaps; thống nhất viết hoa từ viết tắt (ID, URL)
Ruby	RuboCop	`Naming/VariableName`	Bắt buộc snake_case; đặt giới hạn độ dài tối đa

Quy tắc @typescript-eslint/naming-convention của ESLint đặc biệt linh hoạt, cho phép quy tắc đặt tên khác nhau cho từng loại định danh (biến, hàm, lớp, interface, v.v.). Bạn thậm chí có thể bắt buộc các ràng buộc ngữ nghĩa như "biến Boolean phải bắt đầu bằng is, has, hoặc should." Tích hợp linter vào pipeline CI/CD giúp tự động phát hiện vi phạm đặt tên trước khi merge.

Kết luận

Độ dài tên phù hợp tỷ lệ thuận với phạm vi: 1–2 ký tự cho bộ đếm vòng lặp, 8–15 cho biến cục bộ, 15–25 cho hằng số toàn cục. Nguyên tắc này có cơ sở từ khoa học nhận thức — dung lượng bộ nhớ làm việc của con người giới hạn lượng ngữ cảnh mà một tên phải tự mang theo. Phân tích các dự án OSS lớn xác nhận mẫu này, từ trung bình 6 ký tự cho biến của Linux Kernel đến trung bình 12 ký tự của Spring Framework. Mặc dù hỗ trợ tên biến Unicode đang mở rộng, các vấn đề chuẩn hóa và khả năng đọc trong nhóm quốc tế khiến đặt tên chỉ dùng ASCII là lựa chọn thực tế. Tránh viết tắt quá mức và ký pháp Hungary, đồng thời thực thi quy ước đặt tên thông qua linter tích hợp vào pipeline CI/CD. Sử dụng Bộ đếm ký tự để kiểm tra độ dài định danh của bạn.