Java中代理对是UTF-16下表示增补字符的两个连续char组合，需用codePointAt()或codePoints()正确还原为int型Unicode码点，手动解析须检查越界、低位匹配及孤立代理。
Java 中代理对（surrogate pair）不是“特殊字符”，而是 UTF-16 编码下表示增补字符（supplementary character，即 Unicode 码点 ≥ U+10000）的**两个连续 char 的组合**。解析的关键不是“识别字符”，而是**正确还原出它所代表的那个完整 Unicode 码点（int 类型）**。
什么是合法的代理对
一个有效的代理对必须同时满足：
- 第一个 char 是高位代理（high surrogate）：值在 0xD800–0xDBFF（即 55296–56319）之间，可用
Character.isHighSurrogate(c)判断 - 第二个 char 是低位代理（low surrogate）：值在 0xDC00–0xDFFF（即 56320–57343）之间，可用
Character.isLowSurrogate(c)判断 - 两者严格相邻，顺序不可颠倒（高位必须在前）
怎么安全提取码点（推荐方式）
最简单、最健壮的做法是交给 Java 自带的 API 处理，无需手动判断代理：
-
str.codePointAt(i)：传入起始索引，自动识别当前位置是否为高位代理；若是，就合并下一个 char，返回完整码点（int），并隐式跳过第二个代理位置 -
str.codePoints()：返回IntStream，每个元素就是一个真实码点，遍历即得全部字符逻辑单元
示例：
sc-java-to-ts-interface
下载
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
手动解析时必须检查的三件事
若需手动控制（如兼容旧版、自定义错误策略），遍历时务必验证：
-
越界检查：确保
i + 1 ，否则取 <code>charAt(i + 1)会抛异常 -
低位匹配检查：仅
isHighSurrogate为 true 不够，必须再确认下一个 char 确实是合法低位代理 - 孤立代理处理：高位代理后跟的不是低位代理（比如是字母、空格或另一个高位），就不能合成，应按单个 char 或报错处理
常见误操作与后果
以下做法会导致结果错误或逻辑崩溃：
- 直接用
(int) str.charAt(i)强转——对 emoji 返回的是 55357（即 0xD83D），不是真正的 U+1F600（128512） - 只靠
isHighSurrogate()就i++跳位，不验证下一个是否为低位——遇到截断字符串（如网络传输不全）会漏掉或错读 - 把
str.length()当作“字符个数”——含一个 ? 的字符串长度是 2，但它只算 1 个用户可见字符
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
