codePointAt() 能正确获取增补字符的 Unicode 码点,而 charCodeAt() 在遇到代理对时仅返回高代理值;codePointAt() 自动处理代理对计算,且索引指向 UTF-16 单元而非用户感知字符位置。

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 循环,每次用 <code>codePointAt(i)获取当前字符码点; - 根据返回值是否为增补字符,决定下一步跳过几个索引:
✓ 若cp >= 0x10000,说明是增补字符,下个字符从i += 2开始;
✓ 否则i += 1; - 计数器记录“第几个字符”,匹配到目标位置即返回码点。
示例:获取 "A?B" 中第 1 个字符("?")的码点:
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() —— 后者是反向操作,用于从码点构造字符串。

















