驼峰命名规则

🐫 驼峰命名法（Camel Case）完全介绍

驼峰命名法是一种不使用分隔符，而是通过大写字母来区分单词的命名方式。因大写字母像“驼峰”而得名。

一、两种变体

驼峰命名法有两种形式：

注意：严格来说，只有小驼峰才叫”驼峰命名”（camelCase），大驼峰常被称为 PascalCase。但日常交流中常统称”驼峰”。

二、核心规则

基本规则：

1. 不使用任何分隔符（不靠下划线或连字符）
2. 靠大写字母标识单词边界
3. 只能包含字母和数字（但不要以数字开头）
4. 不能有空格或特殊字符

小驼峰规则：

• 第1个单词：全部小写
• 后续单词：首字母大写，其余小写
• 示例：userName、httpClient、getUserData

大驼峰规则：

• 每个单词首字母大写，其余小写
• 示例：UserName、HttpClient、GetUserData

三、详细示例

✅ 正确示例

// 小驼峰（变量/函数）
let userName = "Alice";
let userAge = 25;
let isActive = true;
let httpRequest = new XMLHttpRequest();
let myVariableName = "hello";

function getUserById(id) { }
function calculateAverageScore() { }
function setBackgroundColor(color) { }

// 大驼峰（类/构造函数）
class UserAccount { }
class HttpClient { }
class DatabaseConnection { }
function Person(name, age) { }  // 构造函数

❌ 错误示例

// 错误写法
let UserName = "Alice";      // ❌ 大驼峰用于变量（应小驼峰）
let user_name = "Alice";     // ❌ 用了蛇形
let user-name = "Alice";     // ❌ 用了连字符
let 2ndUser = "Bob";         // ❌ 数字开头
let userName@ = "Alice";     // ❌ 特殊字符
let userName123 ✅ 合法（数字在末尾）

四、适用场景

小驼峰的应用场景：

大驼峰的应用场景：

五、为什么驼峰命名流行？

缺点：

• 长名字可读性稍差：getUserDataFromDatabaseViaAPI vs get_user_data_from_database_via_api
• 依赖大小写敏感（某些系统不区分大小写时可能出错）

六、与其他命名法的对比

七、实战案例

案例 1：JavaScript 项目完整示例

// 变量：小驼峰
let userName = "Alice";
let userAge = 30;
let isLoggedIn = true;

// 函数：小驼峰
function getUserProfile(userId) {
    return { userId, userName };
}

function calculateTotalPrice(price, quantity) {
    return price * quantity;
}

// 类：大驼峰
class UserAccount {
    constructor(userName, email) {
        this.userName = userName;  // 属性：小驼峰
        this.email = email;
    }

    getUserInfo() {  // 方法：小驼峰
        return `${this.userName} (${this.email})`;
    }
}

// JSON 字段：小驼峰
const userData = {
    userId: 123,
    userName: "Bob",
    userEmail: "bob@example.com"
};

案例 2：Python 中类的驼峰命名

# Python 要求类名用大驼峰
class UserProfile:
    def __init__(self, user_name):  # 参数、变量用蛇形
        self.user_name = user_name  # 属性可以是蛇形

    def get_user_info(self):  # 方法用蛇形
        return self.user_name

# 实例化：变量用蛇形
user_profile = UserProfile("Alice")

案例 3：Java 混合使用

public class UserService {  // 类：大驼峰

    private String userName;  // 属性：小驼峰

    public String getUserById(int userId) {  // 方法：小驼峰
        // 局部变量：小驼峰
        String queryResult = "User: " + userId;
        return queryResult;
    }

    public static final int MAX_RETRY_COUNT = 3;  // 常量：大蛇形
}

八、常见缩写与特殊处理

原则：缩写词要么全大写，要么全小写，不要混用（如 HttpRequest 比 HTTPRequest 更常见）。

九、记忆口诀

• 小驼峰，首小写：userName、getData
• 大驼峰，首大写：UserName、GetData
• 变量函数小驼峰，类名接口大驼峰
• Python 类用大驼峰，其他部分用蛇形

十、总结

记住：驼峰是大多数主流语言变量的标准，但在 Python 中只用于类名，Python 变量/函数必须用蛇形！