String.codePointCount() 是 Java 中用于统计字符串在 Unicode 层面上真实字符个数的方法。它能够正确识别和统计像 emoji、特殊符号等由多个代码点组成的字符，避免了使用 length() 方法时可能出现的错误。语法int codePointCount = str.codePointCount(int beginIndex, int endIndex);str：要

Java 中的 `String.codePointCount()` 是精准统计字符串真实 Unicode 字符数量的关键方法，它能正确处理 emoji、增补平面汉字等由多个 UTF-16 编码单元（如代理对）构成的字符，避免 `length()` 因仅返回 char 数而产生的严重误判——例如一个组合 emoji 可能占 11 个 char 却仅代表 1 个语义字符；掌握其安全调用规范（如判空、校验索引、规避非法代理对）、理解与 `chars().count()`/`codePoints().count()` 的区别，并意识到它虽解决码点计数却仍不等同于用户感知的“字形计数”，是编写健壮国际化文本处理逻辑的必备基础。

为什么 String.length() 和 String.codePointCount() 结果可能不同

因为 Java 的 String 内部用 UTF-16 编码，而一个 Unicode 字符（比如 emoji 或某些汉字）可能占两个 char（即一个代理对，surrogate pair）。String.length() 返回的是 char 个数，不是真实字符数；String.codePointCount() 才按 Unicode 码点（code point）计数，能正确处理代理对。

怎么调用 String.codePointCount() 才不会出错

它必须传入合法的索引范围，否则抛 IndexOutOfBoundsException。常见误用是直接传 0 和 str.length() 而不检查字符串是否为空或含代理对。

• 始终用 str.codePointCount(0, str.length()) —— 这是统计整串的标准写法
• 如果字符串为 null，先判空，否则 NPE
• 起始索引必须 ≤ 结束索引，且都不能越界（0 ≤ beginIndex ≤ endIndex ≤ str.length()）
• 不要手动拆分字符串再计数，比如 str.substring().codePointCount(...)，容易索引错位

哪些字符会导致 length() ≠ codePointCount()

所有码点 > 0xFFFF 的 Unicode 字符都会触发代理对机制，典型包括：

• 大部分 emoji："?‍?"、"?"、"?"
• 部分罕见汉字和符号：如 "?"（U+2070E）、"?"（U+2A6A5）
• 增补平面（SMP）中的任意字符，码点范围 0x10000–0x10FFFF

验证示例："?‍❤️‍?‍?".length() 返回 11，但 "?‍❤️‍?‍?".codePointCount(0, str.length()) 返回 1 —— 这是一个带多个 ZWJ 连接符的组合 emoji，仍算作单个 Unicode 字符（尽管底层由多个码点构成，但 codePointCount 统计的是基础码点数量，不解析组合规则）。

替代方案与兼容性注意点

codePointCount() 自 JDK 1.5 起可用，无兼容问题。但要注意它只解决“码点计数”，不解决“视觉字形（grapheme cluster）计数”——比如带变音符号的 "é"（e + ◌́）会被计为 2 个码点，但人眼视为 1 个字符。真要按用户感知计数，得用 java.text.BreakIterator。

另外，别混淆 str.chars().count()（返回 char 流长度，等价于 length()）和 str.codePoints().count()（等价于 codePointCount(0, str.length())），后者更直观但有额外流开销。

真正容易被忽略的是：即使你知道用 codePointCount，也常忘记它对空字符串返回 0，对只含代理对前半部分的非法字符串会抛异常——所以生产代码里，只要输入不可控，就得加 try-catch 或预校验 Character.isSurrogatePair()。

以上就是《String.codePointCount() 是 Java 中用于统计字符串在 Unicode 层面上真实字符个数的方法。它能够正确识别和统计像 emoji、特殊符号等由多个代码点组成的字符，避免了使用 length() 方法时可能出现的错误。语法int codePointCount = str.codePointCount(int beginIndex, int endIndex);str：要统计的字符串。beginIndex：起始索引（包含）。endIndex：结束索引（不包含）。示例public class Main { public static void main(String[] args) { String str = "Hello 😊"; int count = str.codePointCount(0, str.length()); System.out.println("Unicode 字符个数: " + count); // 输出: Unicode 字符个数: 6 } }说明"Hello" 包含 5 个 ASCII 字符，每个占一个代码点。"😊" 是一个 emoji，由一个代码点组成。所以总共有 6 个 Unicode 字符。常见误区使用 str.length() 会返回字符的 编码单元 数量，而不是真正的字符数量。例如，一个 emoji 可能由两个编码单元组成（如 UTF-16 中的代理对），此时 `length》的详细内容，更多关于的资料请关注golang学习网公众号！