StringBuilder.appendCodePoint(int)能正确处理Unicode补充字符，因其直接按码点操作并自动写入合法UTF-16代理对，避免append(char)因截断或手动拼接导致的乱码。
StringBuilder.appendCodePoint(int codePoint) 能正确处理 Unicode 补充字符（即码点大于 0xFFFF 的字符），因为它直接按 Unicode 码点操作，不涉及 char 单元拆分逻辑。
补充字符在 Java 中的表示问题
Unicode 补充字符（如 emoji ?、古汉字、数学符号等）的码点范围是 0x10000 到 0x10FFFF。Java 的 char 类型只有 16 位，无法直接表示这些字符，必须用两个 char（代理对：surrogate pair）来表示——高代理（high surrogate, 0xD800–0xDFFF 中前半段）和低代理（low surrogate, 后半段）。
如果错误地用 append(char) 或字符串字面量拼接补充字符，可能破坏代理对，导致乱码或异常；而 appendCodePoint 绕过这一层，直接写入合法的 UTF-16 序列。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
appendCodePoint 如何安全写入补充字符
- 接收一个 int 参数（必须是合法 Unicode 码点，即在
0x0000–0x10FFFF且不能是代理区0xD800–0xDFFF） - 自动判断是否需要代理对：若码点 ≤
0xFFFF，写入单个char；否则，计算并写入对应的高代理 + 低代理两个char - 内部调用
Character.toChars(codePoint)获取 UTF-16 编码单元，再追加到内部字符数组
对比：append(char) vs appendCodePoint(int)
假设要添加 ?（U+1F30D，码点 127757）：
立即学习“Java免费学习笔记（深入）”；
-
sb.append('\uD83C\uDF0D')—— 手动传入代理对，可行但易出错（顺序/范围写错就乱码） -
sb.append((char)127757)—— 错误！强制截断为char，得到'\uDF0D'（低代理孤立存在），显示为 -
sb.appendCodePoint(127757)—— 正确！自动展开为\uD83C\uDF0D，完整可渲染
实际使用建议
- 只要你知道码点数值（比如从 JSON \u{...}、Character.codePointAt、或 Character.toCodePoint 得到），优先用
appendCodePoint - 避免混合使用：
append(char)和appendCodePoint在同一 StringBuilder 中混用时，需确保代理对不被意外打断（例如中间插入单个 char） - 检查码点合法性：非法码点（如负数、代理区值、超限值）会抛
IllegalArgumentException
