chinese-encoding-handler（中文编码处理程序）

Chinese-Encoding-Handler

描述

中文编码处理工具包，解决 PowerShell 环境下中文文件读写乱码问题。提供自动编码检测、安全文件读写和终端显示修复功能。

触发场景

• 读取中文文件时出现乱码
• 写入中文内容后无法正常显示
• PowerShell 终端中文显示异常
• 需要自动检测文件编码
• 处理包含中文的配置文件或数据文件

使用方法

检测文件编码

.\scripts\encoding-detector.ps1 -Path "C:\path\	o\file.txt"

输出示例：

文件路径：C:\path\	o\file.txt
检测编码：UTF-8-BOM
置信度：100%

安全读取中文文件

.\scripts\safe-read.ps1 -Path "C:\path\	o\file.txt"

带编码参数读取：

.\scripts\safe-read.ps1 -Path "C:\path\	o\file.txt" -Encoding "UTF-8"

安全写入中文文件

.\scripts\safe-write.ps1 -Path "C:\path\	o\file.txt" -Content "中文内容"

指定编码写入：

.\scripts\safe-write.ps1 -Path "C:\path\	o\file.txt" -Content "中文内容" -Encoding "UTF-8-BOM"

修复终端显示

.\scripts\	erminal-fix.ps1

永久修复（需要管理员权限）：

.\scripts\	erminal-fix.ps1 -Permanent

技术细节

编码检测原理

1. BOM 检测：优先检查文件开头的字节顺序标记（BOM）

- UTF-8-BOM: EF BB BF - UTF-16-LE: FF FE - UTF-16-BE: FE FF

1. 内容分析：无 BOM 时，通过字节分布和常见中文字符编码特征判断

- GBK/GB2312：双字节字符特征 - UTF-8：多字节序列特征

1. 置信度评分：根据匹配程度给出 0-100% 置信度

UTF-8-BOM 优势

• ✅ 兼容性好：Windows 程序（记事本、Excel）识别准确
• ✅ 跨平台：Linux/macOS 正常读取
• ✅ 无乱码风险：明确标识编码格式
• ⚠️ 注意：某些 Unix 工具可能不兼容 BOM

兼容性说明

故障排除

常见问题 Q&A

Q1: 为什么读取文件还是乱码？

• 检查文件编码是否被正确识别
• 尝试手动指定 -Encoding 参数
• 使用 encoding-detector.ps1 重新检测

Q2: 写入的文件在记事本打开乱码？

• 使用 -Encoding "UTF-8-BOM" 参数
• 避免使用纯 UTF-8（无 BOM）

Q3: PowerShell 终端显示中文为方框？

• 运行 terminal-fix.ps1
• 检查终端字体是否支持中文
• 使用 -Permanent 参数永久修复

Q4: 批量处理文件时部分失败？

• 检查文件权限
• 确认文件未被其他程序占用
• 查看错误日志定位具体文件

错误代码说明

相关资源

• PowerShell 编码官方文档
• UTF-8 BOM 规范
• GitHub 仓库