加 //IGNORE 可避免 iconv 遇生僻字截断，必须紧贴目标编码名末尾、无空格、大小写不限但建议大写；它删除非法字符而非替换，不解决源编码误判问题。
加 //IGNORE 就行，但必须写对位置、大小写和空格 —— 否则完全无效。
为什么 iconv 一遇到生僻字就截断？
根本不是“转码失败”，而是默认行为：从第一个无法映射到目标编码的字符（比如 Unicode 扩展区汉字、全角破折号 —、项目符号 •、某些 emoji）开始，直接丢弃该字符及之后所有内容。错误提示通常是：Detected an illegal character in input string，并伴随 E_NOTICE。这不是 bug，是 iconv 的严格设计逻辑。
iconv() 第二个参数必须带 //IGNORE 且紧贴编码名
目标编码字符串末尾要拼上 //IGNORE，中间不能有空格，大小写不敏感但建议大写：
-
iconv('UTF-8', 'GBK//IGNORE', $str)✅ 正确 -
iconv('UTF-8', 'gbk //IGNORE', $str)❌ 带空格 → 失效，仍会截断 -
iconv('UTF-8', 'GBK//ignore', $str)⚠️ 可用，但可读性差，易被误删 -
iconv('UTF-8', 'GB2312//IGNORE', $str)⚠️ GB2312 支持字符极少，建议优先用GBK或GB18030
别把 //IGNORE 和 //TRANSLIT 混用
两者容错逻辑完全不同：
立即学习“PHP免费学习笔记（深入）”；
-
//IGNORE：直接删除非法字符，后续照常转换 —— 中文场景下最稳，适合导出 CSV、生成文件名、入库前清洗 -
//TRANSLIT：尝试用近似字符替代（如é → e），但对中文基本无用，还可能触发警告或意外截断 - 不要写成
GBK//IGNORE//TRANSLIT—— 后者会被忽略，只认第一个后缀
容易被忽略的前置条件
//IGNORE 只解决“转换时丢内容”，不修复源头乱码：
- 先确认
$str真的是源编码（比如你写iconv('UTF-8', ...)，那它必须真是 UTF-8 字节流），否则//IGNORE也救不回错判的字节 - Windows 下读取文件时，
file_get_contents()返回的可能是系统 ANSI 编码（如 GBK），不是 UTF-8 —— 别跳过这步转换 - 如果服务器没装 GNU libiconv，系统自带 iconv 行为可能不一致；用
mb_convert_encoding($str, 'GBK', 'UTF-8')是更宽容的备选，但性能略低
真正卡住人的往往不是要不要加 //IGNORE，而是加了却因空格、大小写或源编码误判而失效 —— 每次写完建议立刻用含 • 或 — 的测试字符串验证输出长度是否完整。
