异常教程

java substring（长文解析）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

前言

在编程世界中，字符串（String）是开发者最常操作的数据类型之一。无论是解析日志、处理用户输入，还是构建复杂的数据结构，字符串的切割、拼接和提取都是基础且高频的操作。在 Java 中，substring 方法作为字符串处理的核心工具，其功能强大却也容易被误解。本文将从基础概念、参数细节、常见错误、进阶技巧到实际案例，逐步解析 Java substring 的使用场景与最佳实践，帮助开发者避免“踩坑”并提升编码效率。

基础概念解析：什么是 substring？

substring 方法用于从一个字符串中截取子字符串。可以将其想象为一把“文字剪刀”——通过指定起始和结束位置，精准地剪下字符串中的一段内容。

单参数与双参数版本

Java 中的 substring 方法有两种常用形式：

  1. 单参数版本：substring(int beginIndex)
    • 从 beginIndex 开始截取，直到字符串末尾。
    • 示例： 
      String str = "Hello World";  
String sub = str.substring(6); // 截取从索引6开始的子字符串  
System.out.println(sub); // 输出："World"
  2. 双参数版本：substring(int beginIndex, int endIndex)
    • 截取从 beginIndex（包含）到 endIndex（不包含）的子字符串。
    • 示例： 
      String str = "Java substring";  
String sub = str.substring(4, 11); // 截取索引4到10的位置  
System.out.println(sub); // 输出：" substring"（注意空格被保留）

索引规则：从0开始，但不包含结束位置

Java 字符串的索引从 0 开始计数，且 substring 的结束索引是不包含的。这类似于数学中的区间 [start, end)。例如：

  • 字符串 "ABC" 的索引分布为：A（0）、B（1）、C（2）。
  • substring(0, 2) 将返回 "AB"，而非 "ABC"。

参数细节：边界条件与常见错误

理解 substring 的参数边界是避免运行时错误的关键。

错误1：索引越界

若 beginIndex 小于 0、endIndex 大于字符串长度，或 beginIndex > endIndex，程序将抛出 StringIndexOutOfBoundsException。

  • 示例： 
    String str = "Java";  
// 以下两种情况均会抛出异常  
String err1 = str.substring(-1); // 负数索引  
String err2 = str.substring(5, 3); // beginIndex大于endIndex

错误2：忽略字符串长度

假设字符串长度为 len，合法的 beginIndex 范围是 0 ≤ beginIndex ≤ len，而 endIndex 必须满足 beginIndex ≤ endIndex ≤ len。

  • 安全写法：在不确定字符串长度时，建议先通过 str.length() 获取长度，再计算索引。

进阶技巧：结合其他方法提升处理能力

substring 可与其他字符串方法联动，实现更复杂的逻辑。

技巧1：与 trim() 结合去空格

若需要截取并去除首尾空格，可以链式调用 trim()：

String logLine = " 2023-09-20 14:30:00 INFO: Login Success ";  
String timestamp = logLine.substring(3, 19).trim(); // 截取时间部分并去空格  
System.out.println(timestamp); // 输出："2023-09-20 14:30:00"

技巧2：配合 split() 解析结构化文本

当处理类似 key=value 的键值对时，可以先用 split() 分割，再用 substring 提取特定部分：

String config = "port=8080;timeout=5000";  
String[] pairs = config.split(";");  
for (String pair : pairs) {  
    String key = pair.substring(0, pair.indexOf("="));  
    String value = pair.substring(pair.indexOf("=")+1);  
    System.out.println(key + " : " + value); // 输出"port : 8080"等  
}

性能与内存优化：了解底层实现

在 Java 7 及更早版本中，substring 可能保留原字符数组的引用，导致内存浪费。而从 Java 8 开始，substring 会生成新的字符数组，减少内存占用。因此，在处理超长字符串时，可放心使用此方法。

实战案例：解析日志文件

假设需要从日志行中提取错误代码和消息：

String logEntry = "2023-09-20T14:30:00 ERROR 404: Resource not found at /api/v1/data";  
int errorStart = logEntry.indexOf("ERROR ") + "ERROR ".length(); // 找到错误码起始位置  
int errorCodeEnd = logEntry.indexOf(":", errorStart);  
String errorCode = logEntry.substring(errorStart, errorCodeEnd).trim(); // 获取"404"  
String errorMessage = logEntry.substring(errorCodeEnd + 1).trim(); // 获取错误信息  
System.out.println("Error Code: " + errorCode); // 输出"404"  
System.out.println("Message: " + errorMessage); // 输出"Resource not found at /api/v1/data"

常见问题解答

Q：为什么有时 substring 返回空字符串？
A：当 beginIndex 等于 endIndex，或 beginIndex 超过字符串长度时，结果为空。

Q：如何处理多字节字符（如中文）？
A：Java 的 substring 以字符为单位计数，而非字节。例如，中文字符 “中” 的索引为 0，无需特殊处理。

Q：是否可以用 subSequence() 替代？
A：subSequence() 返回 CharSequence 接口类型，功能与 substring 相似，但在兼容性场景下建议显式使用 substring。

结论

Java substring 是字符串处理的基石工具，但其细节容易被忽视。通过理解索引规则、参数边界、以及结合其他方法，开发者可以高效且安全地完成字符串切割任务。无论是解析配置文件、处理用户输入，还是日志分析，substring 都能提供灵活的支持。掌握其原理与最佳实践，将显著提升代码的健壮性和可维护性。

希望本文能帮助读者系统性地掌握 Java substring 的应用场景与技巧，避免常见陷阱，并在实际项目中游刃有余地运用这一功能。

最新发布

查看更多文章