String不可变性导致常见陷阱：所有修改方法均返回新对象，原字符串不变；需注意null安全、索引边界、==与equals区别、replace系列是否支持正则等。
String不可变性导致的常见陷阱
Java中String是不可变类，所有看似“修改”的方法（如replace()、substring()）都返回新对象，原字符串不变。这常导致逻辑错误：比如循环中反复调用str = str.replace("a", "b")却忘了赋值，或误以为trim()会改变原串。
- 判断是否为空应优先用
str == null || str.isEmpty()，而非str.trim().length() == 0——后者在str为null时直接抛NullPointerException - 拼接大量字符串别用
+（尤其在循环内），JVM虽有优化，但语义上仍是多次创建对象；改用StringBuilder -
==比较字符串内容几乎总是错的，必须用.equals()；只有字符串字面量或明确调用intern()后才可安全用==
区分equals()、equalsIgnoreCase()与compareTo()
equals()严格区分大小写且判空安全（对null返回false）；equalsIgnoreCase()忽略大小写，但同样不接受null参数（传入即NullPointerException）；compareTo()返回整数，用于排序，区分大小写且不支持null。
- 校验用户输入是否等于某固定值，用
"expected".equals(input)比input.equals("expected")更安全——避免input为null时崩溃 - 需要忽略大小写的相等判断，别自己转大小写再比（如
str.toLowerCase().equals("abc")），既低效又可能受Locale影响；直接用equalsIgnoreCase() -
compareTo()结果只看正负零，不要依赖具体数值大小；排序时若需忽略大小写，用String.CASE_INSENSITIVE_ORDER比较器
substring()的索引边界和性能真相
substring(int beginIndex, int endIndex)的endIndex是**不包含**的，且两个索引都必须满足0 ≤ beginIndex ≤ endIndex ≤ str.length()，越界直接抛StringIndexOutOfBoundsException。Java 7u6以后，substring()不再共享底层char[]，所以不必担心内存泄漏，但也不再有“轻量级切片”的假象——每次调用都复制字符。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 提取最后3个字符，别写
str.substring(str.length() - 3)，先检查长度：str.length() >= 3 ? str.substring(str.length() - 3) : str - 从路径中取文件名，用
lastIndexOf('/') + 1算起始位置，比正则或split更轻量 - 频繁子串提取且原串极大？考虑用
CharBuffer.wrap(str.toCharArray(), start, length)避免复制，但注意它只是视图，原数组仍被持有
replace()系列方法的匹配逻辑差异
replace(char oldChar, char newChar)和replace(CharSequence target, CharSequence replacement)都是**全量替换**，不支持正则；而replaceAll(String regex, String replacement)和replaceFirst(String regex, String replacement)才走正则引擎。容易混淆的是replace()能处理"ab".replace("a", "x")，但replaceAll()里"."会被当正则元字符，需转义为"\."。
立即学习“Java免费学习笔记（深入）”；
- 想把所有空格换成下划线，用
str.replace(' ', '_')最直接；用replaceAll(" ", "_")也可，但没必要启动正则引擎 - 替换HTML标签，如
"<b>text</b>".replaceAll("]*>", "")，必须用replaceAll()，replace()无法处理模式 -
replacement字符串中若含$或，在replaceAll()里会被正则解释，需用Matcher.quoteReplacement()包装
真正容易出问题的不是记不住方法名，而是忽略String的不可变本质、null安全性、索引边界含义，以及各replace变体背后是否启用正则——这些点错一个，调试时就容易绕远路。
