GBK/GB2312/GB18030编码文件需统一转为UTF-8才能正常显示和协作，应先用enca精准识别原始编码，再通过iconv安全转换，支持单文件、批量及递归处理，并推荐保留原文件或加后缀验证后再覆盖。
你手头有一堆从Windows或老系统拷过来的文本文件，打开全是乱码，Xcode编译报错、VS Code显示问号、终端cat出来是方块——这些八成是GB2312、GBK或GB18030编码的文件，必须统一转成UTF-8才能正常读写和协作。
先确认原始编码再动手
别急着批量转，先用enca看看真实编码。它比file -I更准，尤其对中文文本：
1. 安装enca：brew install enca
2. 检查单个文件：enca -L zh_CN filename.txt
3. 批量检测当前目录所有.txt：for f in *.txt; do echo "== $f =="; enca -L zh_CN "$f"; done
【不跳过这步】如果检测结果里出现unrecognized或universal，说明enca无法自动识别，得手动试GB2312/GBK/GB18030三种常见编码——否则转完还是乱码。
用iconv逐个安全转换（推荐新手）
适合文件数少于20个、或需要核对每个转换结果的情形。不会覆盖原文件，留出纠错余地：
方法一：生成新文件保留原版
1. 运行命令：iconv -f GBK -t UTF-8 input.txt > output_utf8.txt
2. 用cat output_utf8.txt确认中文显示正常
3. 确认无误后，再用mv output_utf8.txt input.txt覆盖原文件
方法二：直接覆盖（慎用）
执行iconv -f GBK -t UTF-8 input.txt -o input.txt，但【必须提前备份】——这个操作会直接覆写原文件，出错无法回退。
批量转当前目录同类扩展名
一步到位处理几十个.h/.cpp/.txt文件，不进子目录，最常用也最稳妥：
第一步：建输出文件夹避免混杂
执行mkdir -p utf8_out
第二步：循环转换并存入新目录
运行for i in *.txt; do iconv -f GB2312 -t UTF-8 "$i" > "utf8_out/$i"; done
第三步：验证转换结果
进utf8_out目录，随机打开几个文件检查中文是否正常；再用ls -l | wc -l确认文件数量没丢
注意：如果原文件名含空格，"$i"的双引号不能省，否则循环会卡在空格处中断。
递归转换整个项目目录
适合Xcode或Android工程这类多层嵌套结构，把所有源码文件一网打尽：
① 先生成带.utf8后缀的新文件（安全模式）：
find ./ -name "*.java" -exec sh -c 'iconv -f GBK -t UTF-8 "$1" > "$1".utf8' _ {} \;
② 检查生成文件是否全部有效：
运行find ./ -name "*.java.utf8" -size +0c | wc -l，输出数字应等于第一步找到的.java文件数；若为0，说明某次转换失败，需排查对应文件原始编码
③ 批量去掉.utf8后缀（覆盖原文件）：
find ./ -name "*.java.utf8" -exec sh -c 'mv "$1" "${1%.utf8}"' _ {} \;
用enconv自动识别+转换（省心但有局限）
当你面对一堆编码混杂的文件（有的GBK、有的GB2312、有的UTF-8混着），又不想一个个判断时用这个：
1. 确保已安装enca：brew install enca
2. 直接执行转换：enconv -L zh_CN -x UTF-8 *.txt
3. 转换后立即用enca -L zh_CN *.txt复查，确保输出全是UTF-8
这一步操作起来很简单，直接把文件拖进去就行。但【只对纯文本有效】——如果文件里夹着二进制内容（比如PDF头部混在TXT里），enconv会误判并损坏文件。
