脱敏需先识别pii字段再结构化处理：仅对身份证号、手机号等明确定义的敏感字段按路径精准定位，避免全文正则误伤；分级脱敏兼顾安全与可追溯性，如身份证哈希加盐、手机号保留前3后4、中文姓名掩码中间字。
脱敏前必须识别出哪些字段算敏感数据
不是所有字符串都需要脱敏，比如日志里的 StatusCode 或 ThreadId 就不用动。真正要处理的是身份证号、手机号、银行卡号、邮箱、姓名、地址这些在业务规则里明确定义为 PII（个人身份信息）的字段。
常见错误是直接对整个文件做正则替换，结果把 JSON 的 "id" 字段名、XML 的 <id></id> 标签名也给替换了，导致格式损坏。必须基于结构化上下文判断——比如只替换 JSON 中 key 为 "phone"、"idCard"、"email" 对应的 value，而不是全文扫 "1[3-9]\d{9}"。
实操建议：
- 优先用 JSON Schema 或 XML XSD 定义敏感字段路径，再用
JToken.SelectTokens()（Newtonsoft.Json）或JsonNode.GetProperty()（System.Text.Json）精准定位 - 如果只有纯文本日志，先按行切分，再用
Regex.Match(line, @"(? 这类带上下文边界的正则，避免误匹配 - 别忘了检查大小写和空格变体：比如
"PHONE"、" phone "、"mobile_number"都得覆盖到
用 ReplaceValue 而不是 ReplaceAll，避免破坏嵌套结构
很多开发者习惯用 string.Replace() 或 Regex.Replace() 全局替换，但面对 JSON 文件时，这会导致引号、逗号、括号被连带污染。比如把 "name":"张三" 替成 "name":"***" 看似正常，但如果原始值含转义字符 "name":"张\"三"，粗暴替换会破坏 JSON 合法性。
正确做法是解析后修改节点值，再序列化回文本。这样能保格式、保编码、保嵌套层级。
实操建议：
- JSON 场景下，用
JsonDocument.Parse()+JsonElement.Clone()构建可写副本，遍历中调用GetProperty()找到目标字段后，用Utf8JsonWriter写入脱敏值 - XML 场景下，用
XDocument加XPathSelectElements("//user/phone | //order/contact/email")精准选中，再设node.Value = MaskPhone(node.Value) - 纯文本日志若无法结构化解析，至少用
Regex.Replace(line, @"(? MaskIdCard(m.Value))，确保只替换冒号后紧跟的值部分
脱敏算法不能只用星号，要考虑业务可追溯性
简单地把手机号变成 "138****1234" 看似安全，但测试环境查问题时，开发可能需要知道“这批数据原本属于哪个省”。全量打星会丢失地域、运营商等低风险特征，反而增加排查成本。
更合理的做法是分级脱敏：高敏感字段（如身份证号）用哈希+盐脱敏；中敏感字段（如手机号）保留前3后4；低敏感字段（如姓名）只掩码中间字。关键是要让脱敏后的数据仍能在内部系统间关联，又不泄露原始值。
实操建议：
- 身份证号优先用
SHA256(Encoding.UTF8.GetBytes(idCard + salt)).Take(8).ToHexString()，比直接截断更抗碰撞 - 手机号用
phone.Substring(0, 3) + "****" + phone.Substring(7)，注意校验长度，防止"13"这种异常值崩掉 substring - 姓名脱敏要区分中文/英文：中文用
name.Length > 2 ? name[0] + "*" + name[^1] : "*"，英文用Regex.Replace(name, @"(?
文件读写过程容易丢编码或锁住文件
生产环境文件常是 GB2312 编码的日志，或者 UTF-8 with BOM 的配置文件。用 File.ReadAllText(path) 默认走 UTF-8，一读就乱码，后续脱敏结果全是问号。更糟的是，如果用 File.OpenRead() 后没显式 Dispose()，文件句柄一直被占着，下次脚本运行直接抛 IOException: The process cannot access the file。
实操建议：
- 读文件必须显式指定编码：
File.ReadAllText(path, Encoding.GetEncoding("GB2312"))或先用File.ReadAllBytes()判断 BOM 再选编码 - 写文件用
File.WriteAllText(path + ".masked", content, Encoding.UTF8)，别覆盖原文件，留备份 - 大文件（>100MB）别一次性读进内存，改用
StreamReader行读 +StreamWriter行写，配合using确保及时释放句柄
最常被忽略的一点：脱敏脚本上线前，一定要在真实编码、真实权限、真实文件锁场景下跑通一次。本地调试用的 UTF-8 小文件，跟生产上 GBK 编码、被 IIS 进程锁定的 2GB 日志，行为完全不同。
