linux中文乱码需排查locale、文件编码、ssh传输、终端字体等多环节：先运行locale检查lang/lc_ctype/lc_all是否为zh_cn.utf-8，再用file或vim查文件实际编码，若locale -a无zh_cn输出则需sudo locale-gen zh_cn.utf-8，ssh客户端须设utf-8解码，终端需安装并配置中文字体如wqy-zenhei。
Linux中文乱码不是改一个环境变量就能解决的，而是编码链上多个环节断裂的结果：终端解码、文件内容字节流、文件名存储、SSH传输、字体渲染——任一环不匹配，就会显示为???、方块或问号。
查清当前 locale 和文件实际编码
别猜，先看真实状态。终端里执行：locale，重点盯住LANG、LC_CTYPE、LC_ALL三项。如果其中任意一项是C或en_US但没带.UTF-8后缀，就说明 UTF-8 支持没生效。
再检查具体文件的编码：file --mime-encoding filename.txt；或者用vim打开后输入:set fileencoding?。常见误判包括：file报iso-8859-1但内容明明是中文（说明被错判）、vim里fileencoding为空或为latin1（实际是 UTF-8 但没声明）。
LC_ALL优先级最高，会覆盖所有其它LC_*变量。调试时可临时清空：unset LC_ALL。
如果locale -a | grep zh_CN无输出，说明中文 locale 根本没生成，得先运行：sudo locale-gen zh_CN.UTF-8（Debian/Ubuntu）或sudo localedef -c -i zh_CN -f UTF-8 zh_CN.UTF-8（RHEL/CentOS）。
SSH 客户端必须设为 UTF-8 解码，服务端不一定要用 zh_CN
SecureCRT、PuTTY、Windows Terminal 连 Linux 出现中文乱码，主因是客户端按 GBK 解、服务端按 UTF-8 存，两边对不上。关键不在 Linux 端“设成中文”，而在“让客户端按 UTF-8 解码”。
PuTTY：Window → Translation → Remote character set选UTF-8（不是GBK或Automatic）
SecureCRT：Options → Session Options → Appearance → Character Encoding设为UTF-8；同时确认Terminal → Emulation → Terminal为xterm或linux（非vt100）
Linux 服务端保持LANG=en_US.UTF-8更稳妥，只要LC_CTYPE=en_US.UTF-8且终端支持 UTF-8 渲染即可。强行设LANG=zh_CN.UTF-8反而可能触发某些老程序的兼容问题。
检查~/.bashrc里有没有export LANG=C这类硬编码——它会直接禁用 UTF-8。
中文文件名乱码不能靠 iconv，得用 convmv 或 7z
文件内容可转码，但文件名是内核级字节序列，iconv对文件名完全无效。跨 Windows/Linux 传带中文名的文件，本质是让两边用同一套字节解释规则。
Linux 侧创建的中文文件名，本质是 UTF-8 字节存盘；Windows 资源管理器默认用 GBK 解。所以从 Windows 打包过来的 ZIP，解压后文件名大概率乱码。
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
用unzip -O gbk archive.zip指定解码（仅部分unzip版本支持）
不支持-O？换7z x archive.zip——它自动识别常见中文编码，兼容性更好
已存在的乱码文件名，用convmv修复：convmv -f gbk -t utf-8 -r --notest /path/to/dir。注意：--notest才是真执行，漏掉就白跑了。
终端显示方块或问号，八成是字体没装或没生效
即使locale全绿、SSH 编码全对，终端仍显示方块，那基本是字体问题。Linux 终端不会自动 fallback 到中文字体，必须显式配置。
Xshell / Windows Terminal：确认【字体】设置里用了含 CJK 字形的字体，如DejaVu Sans Mono、WenQuanYi Zen Hei、Cascadia Code（需已安装）
命令行检查当前可用中文字体：fc-list :lang=zh。若无输出，说明没装中文字体包：
sudo apt install fonts-wqy-zenhei（Ubuntu/Debian）
sudo yum install wqy-zenhei-fonts（CentOS/RHEL）
装完记得刷新缓存：sudo fc-cache -fv
Qt/Java/Python 程序输出乱码，通常不是系统 locale 问题，而是应用层未声明编码：PYTHONIOENCODING=utf-8、-Dfile.encoding=UTF-8、或 Qt6 中改用QString::fromUtf8()显式转换。
最常被忽略的一点：LC_ALL和LANG冲突、convmv忘加--notest、终端字体路径存在但没 reload——这些细节卡住时，locale和file仍是唯一可信的起点。
