---
title: Tên hàm phải là động từ hoặc động từ + danh từ
impact: MEDIUM
impactDescription: Tên hàm mô tả đúng hành động giúp code dễ đọc và giảm cognitive load khi review PR.
tags: swift, ios, naming, readability, code-quality
---

## Tên hàm phải là động từ hoặc động từ + danh từ

Tên hàm phải bắt đầu bằng động từ hoặc cụm động từ + danh từ, mô tả rõ ràng hành động mà hàm thực hiện. Tránh đặt tên mơ hồ như `data()`, `handle()`, `process()`.

**Incorrect (tên không rõ hành động):**

```swift
class UserManager {
    func data() -> User? { ... }           // Không rõ là lấy hay tạo
    func handle(_ error: Error) { ... }    // handle là gì?
    func process(_ payment: Payment) { ... } // process không nói lên kết quả
    func userInfo(for id: String) { ... }  // thiếu động từ
}
```

**Correct (tên thể hiện hành động rõ ràng):**

```swift
class UserManager {
    func fetchUser(by id: String) -> User? { ... }
    func logError(_ error: Error) { ... }
    func submitPayment(_ payment: Payment) throws { ... }
    func loadUserProfile(userId: String) async throws -> UserProfile { ... }
    func validateEmail(_ email: String) -> Bool { ... }
    func clearCache() { ... }
}
```

**Tools:** SwiftLint custom rule, Code Review