go处理非utf-8路径应使用os.readdir配合utf8.validstring校验；写入控制字符用fmt.sprintf("%q")或strconv.quote；写非utf-8内容须用golang.org/x/text/encoding；csv前需校验utf-8有效性。
Go 字符串默认是 UTF-8 编码，但文件系统、网络挂载盘、旧 Windows 环境或用户上传的压缩包里，常存在非 UTF-8 文件名（如 GBK、Windows-1252）或含控制字符、NUL 字节、非法 UTF-8 序列的路径。直接用 filepath.Walk 或 os.OpenFile 传入这类字符串，可能 panic、静默跳过，或写入乱码。关键不是“转码”，而是绕过字符串解码环节，或在可控位置做显式校验。
filepath.Walk 处理非法 UTF-8 路径会 panic 或静默失败
Windows 上用 GBK 创建的老目录、SMB 共享卷、zip 解压出的文件名，若含非法 UTF-8 字节序列，filepath.Walk 会在内部调用 os.Stat 时 panic 或直接跳过该路径，不报错也不通知。
- 根本原因：Go 运行时把所有路径当 UTF-8 字符串解析，遇到
0xFF 0xFE这类字节就无法 decode - 不要尝试用
strings.ToValidUTF8或正则替换——路径还没进你代码就被拦下了 - 正确做法：改用
os.ReadDir，它返回fs.DirEntry，entry.Name()是原始字节转字符串（不强制校验 UTF-8） - 拿到
entry.Name()后，立刻用utf8.ValidString()判断：无效则跳过、记录日志，或走 fallback 路径
写入含控制字符或 NUL 的字符串到文件
如果原始数据来自二进制输入、日志解析或用户粘贴，可能含 、 、
甚至不可见控制符，直接 file.WriteString(s) 会原样写入，可能破坏 CSV/JSON 格式或导致解析失败。
- 调试/日志场景优先用
fmt.Sprintf("%q", s)：自动转义所有非打印字符，输出带引号、可读、可复制回代码 - 需要严格 Go 字面量兼容（比如生成配置代码），用
strconv.Quote(s)：它处理 NUL 字节为U0001f680，且保证可被strconv.Unquote安全还原 - 避免用
strings.ReplaceAll(s, " ", "\n")手动替换——漏掉u2028等，且无法处理多字节 Unicode 边界
写入非 UTF-8 编码的文件内容（如 Windows-1252）
Go 字符串只能是 UTF-8，要写入其他编码（例如遗留系统要求的 Windows-1252、ISO-8859-1），必须绕过字符串层，操作字节流。
- 用
golang.org/x/text/encoding，例如charmap.Windows1252 - 不要自己
[]byte(s)强转——这仍是 UTF-8 字节，不是目标编码 - 正确流程：
encoder := charmap.Windows1252.NewEncoder(); w := encoder.Writer(file); w.Write([]byte(utf8Str))—— 编码器负责转换 - 必须显式调
encoder.Close()检查尾部错误（如未完成的多字节序列），Write返回值不反映编码错误
CSV 写入含特殊字符字段时自动转义失效？
encoding/csv 默认能处理含逗号、换行、双引号的字段，但前提是字段是合法 UTF-8 字符串。若字段含非法 UTF-8 字节（比如从损坏 zip 中读出的文件名），csv.Writer.Write 会 panic。
- 写入前先校验：
if !utf8.ValidString(field) { field = "INVALID_UTF8" } - 不要依赖
csv.Writer.Comma改分隔符来“避开”问题——非法字节在写入前就已存在 - 若需保留原始字节（如导出给非 UTF-8 系统消费），得手动用
io.WriteString+ 自定义分隔逻辑，放弃encoding/csv
最易被忽略的是：多个 goroutine 并发调 os.ReadDir 同一目录时，os.Rename 可能因竞态失败；而 os.ReadDir 本身不保证顺序，也不保证跨平台行为一致——Windows 和 Linux 对 . 和 .. 的返回顺序不同，别写死索引取 entry。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
