parseTime=true使MySQL时间字段自动解析为time.Time类型，但需配合loc=UTC或loc=Local等显式时区参数，否则默认按本地时区解释导致8小时偏差。
Go 环境本身不自带数据脱敏能力，所谓“配置脱敏组件”本质是：装好 Go 编译器 + 选对库 + 写清楚规则 + 避开字段标签和时区陷阱。下面直奔实操。
go install 后必须验证 GOPATH 和 GOBIN 是否生效
很多脱敏脚本运行时报 command not found: go 或找不到自定义工具，根源常在环境变量没刷进当前 shell。macOS/Linux 下别只改 ~/.zshrc 就以为完事——新开终端后要手动 source ~/.zshrc；Windows 则需确认系统级环境变量已重启终端生效。
验证方式不是看 go version，而是跑：go env GOPATH → 应输出类似 /Users/xxx/gogo env GOBIN → 若为空，说明没设，此时 go install 的二进制不会出现在 PATH 中
- GOBIN 未设时，
go install默认把可执行文件放$GOPATH/bin，该路径必须加入PATH - 用
go build -o ./bin/desensitize main.go绕过 GOBIN 依赖更稳妥 - CI/CD 流水线中建议显式设置
GOBIN=$(pwd)/bin，避免权限或路径歧义
viper.ReadInConfig() 后不调用 WatchConfig() = 配置永远不热更新
医疗脱敏规则常随合规要求动态调整（比如某类病历字段从“掩码”升级为“哈希”），硬编码在代码里等于每次改都得发版。viper 支持 YAML 配置热加载，但默认关闭 —— WatchConfig() 必须在 ReadInConfig() 成功之后立刻调用，否则监听无声无息失败。
立即学习“go语言免费学习笔记（深入）”；
常见坑点：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
-
AddConfigPath("./configs")中的./configs目录必须真实存在，哪怕为空；不存在时WatchConfig()不报错但不工作 - YAML 里写
mask_rules:，代码里要用viper.GetStringSlice("mask_rules")，类型错会导致空切片 - 若配置含嵌套结构如
database.url，直接viper.GetString("database.url")即可，不用自己json.Unmarshal
struct tag 里的 csv:"xxx" 不是装饰，是解析 CSV 的开关
读取患者 CSV 文件时，如果 PatientRecord 字段没加 csv:"name" 这类 tag，第三方库（如 gocsv 或 encoding/csv 配合反射）根本无法把 CSV 头部 “姓名” 映射到 Name 字段 —— 它只会按字段声明顺序瞎填，导致身份证号进 Name、年龄进 IDCardNumber。
关键细节：
- tag 值必须与 CSV 文件第一行的列名完全一致（包括大小写、空格、下划线）
- 若 CSV 列名含空格（如
"Patient ID"），tag 得写成csv:"Patient ID"，不能用下划线替代 - 用
encoding/csv原生包时，不依赖 tag，但需手动records[0][i]按索引取值，易出错；用gocsv等库才真正靠 tag 驱动 - 字段类型不匹配（如 CSV 中 "age" 是字符串 "25"，而 struct 定义为
Age int）会静默失败或 panic，务必加if err != nil检查
MySQL 连接字符串里 parseTime=true 和 loc=Local 是脱敏服务启动失败的高频原因
脱敏后数据要入库，sql.Open() 成功不代表能干活。如果数据库字段含 DATETIME，而连接串漏了 parseTime=true，Go 会把时间当字符串返回，后续做时间范围过滤或格式化时直接 panic；若 loc=Local 没配，而数据库用 UTC 存储，就会出现“查昨天的数据却返回今天”的时区错乱。
正确写法示例：
db, err := sql.Open("mysql", "appuser:str0ng-p@ss@tcp(127.0.0.1:3306)/edc_db?parseTime=true&loc=UTC")注意：
-
parseTime=true是必须项，不加则time.Time字段全为零值 -
loc=UTC还是loc=Local取决于 MySQL 服务器的time_zone设置，用SELECT @@time_zone;查，别猜 - 连接池参数必须显式设：
db.SetMaxOpenConns(20)、db.SetConnMaxLifetime(5 * time.Minute)，否则默认不限制，压测时瞬间打爆 MySQL
脱敏逻辑本身不难，难的是字段映射不漏、配置变更不重启、时间解析不错位、连接池不爆炸——这些点没卡死，再复杂的正则掩码或哈希逻辑都只是 if-else 的事。
