概述
iconv命令是文本编码转换工具，核心作用是将文本文件/标准输入从源字符编码转换为目标字符编码，解决因编码不兼容导致的中文乱码、跨平台文本读取失败等问题（如Windows的GBK文件在Linux的UTF-8终端中乱码、UTF-8文件在GBK编辑器中显示异常），是跨平台、跨系统文本处理的必备工具。
资料合集：https://pan.quark.cn/s/6fe3007c3e95、https://pan.quark.cn/s/561de99256a5、https://pan.quark.cn/s/985f55b13d94、https://pan.quark.cn/s/d0fb20abd19a
一、核心特点
- 全编码支持：支持几乎所有主流字符编码（UTF-8、GBK/GB2312、GB18030、ASCII、ISO-8859-1等）；
- 双输入方式：可处理指定文件，也可通过管道读取标准输入（适配命令组合）；
- 灵活输出：可直接覆盖原文件（需指定参数）、输出到新文件或标准输出；
- 乱码修复：是解决Linux/Windows/macOS之间文本乱码的核心工具，无替代方案；
- 轻量高效：纯命令行操作，批量转换多个文件时可配合shell脚本快速实现。
二、基本语法
# 基础用法：转换文件编码，输出到标准输出iconv-f 源编码 -t 目标编码 文件名# 常用用法：转换后写入新文件（推荐，避免覆盖原文件）iconv-f 源编码 -t 目标编码 源文件 -o 目标文件# 管道用法：处理其他命令的输出编码命令|iconv-f 源编码 -t 目标编码三、核心选项
iconv选项围绕编码指定、输出控制、错误处理设计，无冗余功能，日常使用仅需掌握3个核心选项，其余为进阶补充：
| 选项 | 全称 | 核心作用 | 实用场景 |
|---|---|---|---|
-f | --from-code=编码 | 指定源文件的字符编码（必加） | 所有转换场景，必须明确源编码 |
-t | --to-code=编码 | 指定目标字符编码（必加） | 所有转换场景，必须明确目标编码 |
-o | --output=文件 | 指定转换后的输出文件 | 保留原文件，将转换结果写入新文件（推荐） |
-c | —— | 忽略转换过程中的无效字符 | 源文件含特殊乱码字符，避免转换中断 |
-s | --silent | 静默模式，不输出转换过程的错误信息 | 批量转换文件，避免终端被错误信息刷屏 |
--list | —— | 列出iconv支持的所有字符编码 | 不确定编码名称时，查询可用编码（如GBK的别名） |
四、高频实用编码
iconv支持上千种编码，但日常使用仅需掌握6种核心编码，覆盖99%的跨平台场景，重点记编码标准名称（避免别名识别失败）：
| 编码名称 | 适用场景 | 说明 |
|---|---|---|
UTF-8 | Linux/macOS系统、网页、大多数编程文件 | 目前最通用的编码，推荐作为目标编码 |
GBK | Windows系统、中文Windows原生文件（如txt/ini） | 中文Windows的默认编码，兼容GB2312 |
GB2312 | 老式中文Windows文件、部分传统软件 | 仅支持简体中文，已被GBK替代（兼容） |
GB18030 | 国标中文编码 | 支持简繁中文，是GBK的超集，更全面 |
ASCII | 纯英文文本、老式配置文件 | 仅支持英文字母/数字/符号，无中文 |
ISO-8859-1 | 西方语言文本、部分Linux老文件 | 也叫Latin-1，无中文，易导致中文乱码 |
五、经典实操示例
iconv的核心使用场景是解决乱码，以下示例贴合真实工作场景：Windows文件在Linux乱码、Linux文件在Windows乱码、批量转换文件编码等。
场景1：核心场景——Windows GBK文件在Linux UTF-8终端乱码
Windows新建的中文txt文件（默认GBK编码），在Linux的UTF-8终端中打开显示为���й���，用iconv转换为UTF-8即可修复：
# 源编码GBK，目标编码UTF-8，原文件win_gbk.txt，转换后写入linux_utf8.txticonv-f GBK -t UTF-8 win_gbk.txt -o linux_utf8.txt执行后，linux_utf8.txt在Linux终端中可正常显示中文，无乱码。
场景2：反向场景——Linux UTF-8文件在Windows GBK编辑器乱码
Linux中创建的UTF-8中文文件，在Windows记事本（默认GBK）中打开乱码，转换为GBK即可：
# 源编码UTF-8，目标编码GBK，原文件linux_utf8.txt，转换后写入win_gbk.txticonv-f UTF-8 -t GBK linux_utf8.txt -o win_gbk.txt场景3：管道用法——实时转换命令输出的编码
Linux中某命令输出的中文为GBK编码（如部分Windows下的工具在Linux运行），终端显示乱码，通过管道实时转换为UTF-8：
# 命令输出GBK编码，实时转换为UTF-8后在终端显示some_command|iconv-f GBK -t UTF-8场景4：忽略无效字符——避免转换因乱码中断
源文件含特殊无效字符（如传输过程中损坏的字符），直接转换会报错中断，加-c忽略无效字符：
iconv-f GBK -t UTF-8 -c bad_file.txt -o good_file.txt场景5：查询iconv支持的所有编码
若不清楚目标编码的标准名称（如GBK是否有别名gbk/GbK），用--list查询，支持模糊过滤：
# 列出所有支持的编码（输出较多）iconv--list# 过滤查询中文相关编码（推荐，精准定位）iconv--list|grep-i gbkiconv--list|grep-i utf场景6：批量转换目录下所有文件的编码
需将目录下所有.txt文件从GBK转换为UTF-8，配合for循环批量实现，保留原文件（加.bak后缀备份）：
# 批量转换当前目录下所有txt文件：GBK→UTF-8，原文件备份为*.txt.bakforfilein*.txt;doiconv-f GBK -t UTF-8"$file"-o"${file%.txt}_utf8.txt"# 可选：备份原文件mv"$file""$file.bak"done六、乱码排查与解决思路
使用iconv的前提是准确判断源文件的编码，若源编码指定错误，转换后会出现新的乱码，以下是快速排查文件编码的2个核心命令（与iconv配套使用）：
方法1：用file命令判断文件编码
file命令可识别文件的类型和字符编码，直接定位源编码：
# 查看文件编码（关键看「charset=xxx」）file-i 文件名示例输出：
win_gbk.txt: text/plain; charset=gbk # 明确源编码为GBK linux_utf8.txt: text/plain; charset=utf-8 # 明确源编码为UTF-8方法2：用enca命令检测编码
enca是专门的编码检测工具，比file更精准，部分Linux发行版未预装，需手动安装：
# 安装enca（CentOS/RHEL）yuminstall-y enca# 安装enca（Ubuntu/Debian）aptinstall-y enca# 检测文件编码（自动识别中文编码）enca 文件名示例输出：
Simplified Chinese National Standard; GB2312 # 识别为GB2312（兼容GBK）七、关键注意事项
- 源编码必须准确：这是
iconv转换成功的核心前提，若源编码指定错误（如把GBK当成UTF-8），转换后会出现更严重的乱码，需用file -i/enca先检测； - 避免直接覆盖原文件：
iconv无默认的“覆盖保护”，若直接将输出重定向到原文件（iconv -f GBK -t UTF-8 file.txt > file.txt），会导致原文件被清空，必须用-o指定新文件； - GBK与GB2312兼容：源编码为GB2312的文件，可用
-f GBK指定（兼容），反之亦然，推荐优先用GBK（覆盖范围更广）； - UTF-8 BOM问题：部分Windows工具会给UTF-8文件加BOM头（
\ufeff），Linux下部分命令（如cat）会识别为乱码，可先用sed '1s/^\ufeff//'去除BOM头再转换； - 二进制文件禁止转换：
iconv仅支持文本文件，对二进制文件（如压缩包、exe、图片、视频）执行编码转换会导致文件损坏，无法恢复； - 编码名称大小写无关：
iconv对编码名称大小写不敏感，-f gbk和-f GBK效果一致，推荐用大写（规范）。
八、与dos2unix的区别
iconv和dos2unix均为跨平台文本处理工具，但解决的问题完全不同，无替代关系，常配合使用：
| 命令 | 核心解决问题 | 处理对象 | 实用场景 |
|---|---|---|---|
iconv | 字符编码不兼容导致的中文乱码 | 文本的字符编码（UTF-8/GBK等） | Windows/Linux/macOS之间的中文文本乱码 |
dos2unix | 换行符不兼容导致的文本格式错误 | 文本的换行符（\r\n/\n） | Windows文件在Linux中出现^M符号、脚本执行报错 |
经典组合：同时修复编码+换行符问题
Windows的GBK文件在Linux中，常同时存在编码乱码和换行符^M问题，需先转编码，再转换行符（或反之）：
# 步骤1：GBK→UTF-8，修复乱码iconv-f GBK -t UTF-8 win_file.txt -o linux_utf8.txt# 步骤2：dos2unix转换换行符，去除^Mdos2unix linux_utf8.txt九、高频组合用法
1. 修复Windows GBK文件Linux乱码+换行符
iconv-f GBK -t UTF-8$1-o${1%.txt}_utf8.txt&&dos2unix${1%.txt}_utf8.txt2. 批量转换目录下所有GBK文件为UTF-8
forfilein*.txt *.sh *.conf;doif[-f"$file"];theniconv-f GBK -t UTF-8 -c"$file"-o"${file}.utf8"echo"转换完成：$file→${file}.utf8"fidone3. 实时转换GBK编码的日志为UTF-8并查看
tail-f gbk_log.log|iconv-f GBK -t UTF-84. 转换UTF-8文件为GBK，适配Windows记事本
iconv-f UTF-8 -t GBK -c linux_utf8.txt -o win_gbk.txt十、总结
iconv是Linux跨平台文本编码转换的核心工具，核心价值是解决因字符编码不兼容导致的中文乱码问题，是Windows/Linux/macOS之间文本交互的必备工具，其核心要点可总结为：
- 核心选项：
-f（源编码）、-t（目标编码）、-o（输出文件）三剑客，必加； - 编码判断：转换前先用
file -i 文件名检测源编码，避免指定错误； - 避坑关键：绝不直接覆盖原文件，用
-o指定新文件；仅处理文本文件，禁止处理二进制文件； - 经典组合：与
dos2unix配合，同时修复编码乱码和换行符^M问题； - 通用原则：跨平台文本推荐统一转换为UTF-8（兼容性最好，无乱码风险）。
