问题核心原因
Linux终端或vi中显示文件夹/文件名乱码，本质是字符编码不匹配造成的，常见场景包括：
- 文件名包含中文/日文/韩文等非ASCII字符
- 系统环境变量
LANG或LC_*设置错误 - 通过SSH连接时客户端与服务端编码不一致
- 文件来自其他操作系统（如Windows默认GBK编码）
解决方案分步指南
第一步：检查当前系统编码环境
在终端执行以下命令确认编码设置：
locale
关键变量说明：
LANG：系统默认语言环境LC_CTYPE：字符分类与处理规则- 正常显示中文需设置为
zh_CN.UTF-8或en_US.UTF-8
第二步：临时修正终端编码（SSH场景）
若通过SSH连接，在客户端调整编码设置：
- Windows PuTTY：
Connection > Data > "Received data assumed to be in"选择UTF-8 - Linux/macOS终端：连接时添加
-o ServerAliveInterval=60并确保终端设置为UTF-8
第三步：在vi中强制指定编码打开文件
使用vi查看含乱码文件夹内的文件时，启动命令添加编码参数：
vi -c "e ++enc=gbk" filename.txt # 尝试GBK编码（常见中文编码） vi -c "e ++enc=big5" filename.txt # 尝试Big5编码（繁体中文） vi -c "e ++enc=utf-8" filename.txt
vi内操作技巧：
- 打开文件后切换编码：输入命令模式
:e ++enc=gbk - 测试可用编码：
:set fileencoding?查看当前识别编码 - 保存转换编码：
:set fileencoding=utf-8+:w永久转码
第四步：修复终端显示（非vi操作）
若需直接操作乱码文件夹：
# 使用convmv工具重命名文件（需安装） convmv -f gbk -t utf-8 --notest -r /path/to/folder/
参数说明：
-f：原始编码-t：目标编码--notest：实际执行操作（去掉此参数仅模拟）-r：递归处理子目录
第五步：永久修复系统环境
编辑 /etc/environment 添加全局设置：
sudo vi /etc/environment
LANG="zh_CN.UTF-8"
LC_ALL="zh_CN.UTF-8"保存后重启系统生效。
故障排除清单
| 现象 | 解决方案 |
|———————|—————————-|
| vi内文本乱码 | :e ++enc=gb18030 |
| 文件名显示方块 | 终端执行 export LC_ALL=zh_CN.UTF-8 |
| 保存后仍乱码 | 在vi中用 :set bomb 写入UTF-8 BOM头 |
| 跨平台文件乱码 | 安装 dos2unix 工具清除CR/LF字符 |
关键预防措施
- 统一UTF-8编码：所有Linux系统建议设置
LANG=en_US.UTF-8或zh_CN.UTF-8 - SSH客户端配置：确保客户端与服务端均使用UTF-8
- 文件传输协议：
- 使用SCP/SFTP时添加
-o AddressFamily=inet参数 - 避免用FTP传输中文文件（建议用rsync）
- 使用SCP/SFTP时添加
- 脚本安全处理：在Shell脚本开头添加
#!/bin/bash -eu避免编码错误扩散
技术原理说明
乱码的产生源于字符编码三阶段不一致：
- 存储编码：文件系统记录文件名时的编码（如ext4默认UTF-8）
- 传输编码：SSH/Telnet等协议传输时的转换规则
- 显示编码：终端仿真器（如xterm）的渲染方式
vi作为文本编辑器，仅能解决文本内容的编码识别问题，文件夹名乱码需通过终端环境修正。
引用说明：本文解决方案参考Linux man-pages v6.05中关于locale(7)的规范，以及Vim官方文档[1]关于
++enc参数的说明，编码转换测试基于GNU convmv 2.05工具验证。
[1] Vim Documentation::help encoding-values
[2] Linux Programmer’s Manual: locale(7)
原创文章，发布者：酷番叔，转转请注明出处：https://cloud.kd.cn/ask/5752.html
