当前位置：首页 > 文章列表 > 文章 > java教程 > 在 Java 中，String.codePointAt(int index) 方法用于获取字符串中指定索引位置的 Unicode 原始码点（code point）数值。这个方法特别适用于处理包含增补字符（即超出基本多语言平面 BMP 的字符，如 emoji 或某些特殊符号）的字符串。✅ 语法public int codePointAt(int index)参数：index 是要查询的字符位置（从

在 Java 中，String.codePointAt(int index) 方法用于获取字符串中指定索引位置的 Unicode 原始码点（code point）数值。这个方法特别适用于处理包含增补字符（即超出基本多语言平面 BMP 的字符，如 emoji 或某些特殊符号）的字符串。✅ 语法public int codePointAt(int index)参数：index 是要查询的字符位置（从

2026-05-15 08:24:47 0浏览收藏

Java 和 JavaScript 中的 `codePointAt()` 方法是正确处理 Unicode 增补字符（如 emoji、古汉字等码点 ≥ 0x10000 的字符）的关键工具，它能自动解析 UTF-16 代理对并返回完整的 Unicode 码点值，彻底避免了传统 `charCodeAt()` 或 `charAt()` 在面对多单元字符时仅返回碎片化高代理值的陷阱；文章深入剖析了其索引机制（指向 UTF-16 单元而非用户感知字符）、边界行为、安全遍历实践及与手动计算码点的对比，帮助开发者真正理解并可靠地操作现代 Unicode 字符串。

怎么通过 String.codePointAt() 精确获取字符串中指定索引位置的 Unicode 原始码点数值

String.codePointAt() 是 JavaScript 中用于正确处理 Unicode 字符（尤其是增补字符，即码点 > 0xFFFF 的字符）的关键方法。它能避免 charCodeAt() 在遇到代理对（surrogate pair）时返回错误的单个 UTF-16 单元值的问题。

为什么不能只用 charCodeAt()？

JavaScript 字符串内部使用 UTF-16 编码。大多数常用字符（如 ASCII、常见汉字）占用 1 个 UTF-16 单元（即 2 字节），charCodeAt() 返回的值就是其 Unicode 码点。但 emoji（如 ?）、古汉字、部分符号等属于 Unicode 增补平面（U+10000 及以上），在 UTF-16 中以两个连续的 16 位单元（高代理 + 低代理）表示。此时：
• charCodeAt(i) 只返回第一个单元（高代理），不是真实码点；
• charCodeAt(i+1) 返回第二个单元（低代理），单独看也无意义；
• 真实码点需通过公式 (high - 0xD800) * 0x400 + (low - 0xDC00) + 0x10000 计算 —— 而 codePointAt() 自动完成该逻辑。

codePointAt() 的基本用法与索引含义

调用 str.codePointAt(index) 时，index 指的是 UTF-16 编码单元的位置（从 0 开始），不是“字符数”。这意味着：

对于 BMP 字符（如 "A"、"中"），每个字符占 1 个单元，索引直接对应字符位置；
对于增补字符（如 "?"、"?"），它占 2 个连续单元，因此要获取该字符的码点，必须传入其**第一个单元的索引**（即高代理所在位置）；
若传入的是低代理单元的索引（如高代理后一位），codePointAt() 仍会尝试解析代理对 —— 但前提是前一个单元是有效的高代理；否则只返回该位置的 UTF-16 值（不组合）。

安全获取指定“字符位置”的码点（推荐实践）

如果目标是“第 n 个用户感知的字符”（例如字符串 "Hi?!" 中第 2 个字符 ?），不能简单用 n 当作 codePointAt() 的参数，因为增补字符占两个索引。应结合 String.prototype.length 和遍历逻辑：

用 for (let i = 0; i 循环，每次用 codePointAt(i) 获取当前字符码点；
根据返回值是否为增补字符，决定下一步跳过几个索引：
✓ 若 cp >= 0x10000，说明是增补字符，下个字符从 i += 2 开始；
✓ 否则 i += 1；
计数器记录“第几个字符”，匹配到目标位置即返回码点。

示例：获取 "A?B" 中第 1 个字符（"?"）的码点：

let str = "A?B";
let charIndex = 1; // 想取第 1 个字符（从 0 开始计数）
let cp;
for (let i = 0, count = 0; i   if (count === charIndex) {
    cp = str.codePointAt(i);
    break;
  }
  i += str.codePointAt(i) >= 0x10000 ? 2 : 1;
}
console.log(cp.toString(16)); // → "20bb7"（? 的码点）

边界情况与注意事项

• 若索引超出字符串长度（>= str.length），返回 undefined；
• 若索引为负数或非数字，会被转为 0（即取首字符）；
• 对于无效代理对（如孤立的高代理后无匹配低代理），codePointAt() 返回高代理本身的值（不组合），行为与 charCodeAt() 一致；
• 不要混淆 codePointAt() 和 String.fromCodePoint() —— 后者是反向操作，用于从码点构造字符串。

今天关于《在 Java 中，String.codePointAt(int index) 方法用于获取字符串中指定索引位置的 Unicode 原始码点（code point）数值。这个方法特别适用于处理包含增补字符（即超出基本多语言平面 BMP 的字符，如 emoji 或某些特殊符号）的字符串。✅ 语法public int codePointAt(int index)参数：index 是要查询的字符位置（从 0 开始）。返回值：该位置对应的 Unicode 码点值（整数）。📌 注意事项索引有效性：index 必须是有效的，即 0