convert.fromhexstring()仅支持无分隔符、无前缀的连续十六进制字符串(如"48656c6c6f"),使用前须清洗空格、"0x"等并校验长度为偶数;.net 5+可直接调用,旧版本需手动解析。

十六进制字符串转 byte[] 时必须先去除空格和前缀
常见错误是直接对 "0x48 0x65 0x6C 0x6C 0x6F" 或 "48 65 6C 6C 6F" 调用 Convert.FromHexString(),结果抛出 FormatException。这个方法只接受**连续、无分隔符、无前缀**的十六进制字符串(如 "48656C6C6F")。
实操建议:
- 用
Replace("0x", "").Replace(" ", "").Replace("\t", "").Replace("\r", "").Replace("\n", "")清洗原始字符串 - 若不确定输入格式(比如来自日志或调试输出),优先用正则提取所有十六进制数字:
Regex.Replace(input, @"[^0-9A-Fa-f]", "") - 注意长度必须为偶数,奇数长度说明数据损坏或截断,应提前校验
使用 Convert.FromHexString() 写入文件前要检查 .NET 版本
Convert.FromHexString() 是 .NET 5+ 引入的 API,在 .NET Framework 4.8 或 .NET Core 3.1 及更早版本中不可用。如果项目不能升级,得手动实现解析逻辑。
实操建议:
- .NET 5+ 直接用:
byte[] data = Convert.FromHexString(cleanedHex); - .NET Framework 用户可用
Enumerable.Range(0, s.Length / 2).Select(i => Convert.ToByte(s.Substring(i * 2, 2), 16)).ToArray(),但要注意异常捕获 - 别依赖
BitConverter.ToString()的逆操作——它加了短横线,不是原始 hex 字符串
写入二进制文件时 FileStream.Write() 比 File.WriteAllBytes() 更可控
虽然 File.WriteAllBytes(path, bytes) 最简捷,但在处理大文件或需要流式写入(比如边解码边写)时,FileStream 更可靠,且能避免内存峰值。
实操建议:
- 小文件(File.WriteAllBytes() 完全没问题
- 大文件务必用
using var fs = new FileStream(path, FileMode.Create, FileAccess.Write, FileShare.None, 4096, FileOptions.SequentialScan);,显式指定缓冲区大小和访问选项 - 写入后不调用
fs.Flush()——Dispose()已隐式完成;但若中途异常,确保try/finally或using正确包裹
验证还原结果是否正确:别只看文件大小
文件大小一致 ≠ 数据正确。Hex 还原出错常表现为头部损坏(如 PNG 的 89 50 4E 47 变成 89504E4 少一位),导致程序无法识别。
实操建议:
- 用十六进制编辑器(如 HxD、xxd)打开还原后的文件,比对前 16 字节是否与原始 hex 字符串开头一致
- 对已知格式文件(如 JPEG、PDF),检查魔数:
bytes[0] == 0xFF && bytes[1] == 0xD8等 - 若原始 hex 来自 Base64 编码再转 hex,容易多一层编码——确认源头是纯 hex,不是
Convert.ToBase64String(Convert.FromHexString(...))套娃
实际还原过程最易被忽略的是输入清洗和版本兼容性。哪怕 hex 字符串只多一个空格或换行,Convert.FromHexString() 就会静默失败;而旧项目里硬塞新 API,编译都过不去。










