Java字符串首字母大写方法优化：解决全大写用户名失效问题

API 探路者

2026-5-9

解决用户名首字母大写（兼容全大写输入）的重构方案

嗨，我懂你遇到的痛点了——原来的方法只处理了首字母转大写，但如果输入是全大写的用户名（比如"JOHN"），后面的字符还是大写，完全达不到「先全小写再首字母大写」的效果对吧？

原代码的问题分析

先看看原代码的逻辑：

static String upperFirstCase(String str) { 
    return "${str[0].toUpperCase()}${str.substring(1)}"; 
}

它仅把第一个字符转为大写，完全保留了原字符串从第二个字符开始的大小写状态，所以当输入是全大写字符串时，输出还是全大写，根本没实现需求里的「先全小写」步骤。

重构后的实现思路

我们要把逻辑顺序彻底调整：

先把整个字符串转为全小写，确保所有字符都是小写状态
再将首字符单独转为大写
把大写的首字符和剩下的小写部分拼接起来
额外处理空字符串或null的边界情况，避免索引越界报错

重构后的代码

这里提供两种写法，你可以根据习惯选：

写法一（简洁版，用`replaceFirst`）

static String upperFirstCase(String str) {
    // 先处理空值或空字符串，避免报错
    if (str == null || str.isEmpty()) {
        return str;
    }
    // 先转全小写，再把第一个字符替换为大写
    return str.toLowerCase().replaceFirst(".", it.toUpperCase());
}

写法二（直观版，适合理解基础逻辑）

static String upperFirstCase(String str) {
    if (str == null || str.isEmpty()) {
        return str;
    }
    // 第一步：全字符串转小写
    String lowerCaseStr = str.toLowerCase();
    // 第二步：首字母大写 + 剩余小写部分拼接
    return lowerCaseStr.charAt(0).toUpperCase() + lowerCaseStr.substring(1);
}