envdiff
一个极简的命令行工具,用来对项目的 .env 与 .env.example 模板进行静态对比。
在不泄露或读取密钥值的前提下,自动发现新增配置、遗漏字段及多环境漂移。它完全在本地运行,没有服务端,也绝不发起网络连接。
我们在维护多套微服务配置时写下了它:代码拉取后经常因为团队成员新增了环境变量却未同步更新示例模板,导致本地运行诡异报错。
envdiff 专为快速排查和 CI 门禁检查而设计。
文档索引
-
安装指南
单文件静态编译二进制下载,或通过源码一行构建。支持 Linux x86_64、macOS (Apple Silicon/Intel) 及 Windows。
-
快速开始
三分钟内完成首次环境检查,掌握
check、sync、--strict等常用命令行指令。 -
配置说明
详细了解
envdiff.toml:自定义忽略字段、类型校验规则、注释保留选项以及多环境分组机制。 -
常见问题
如何确保真实 Secret 绝不被打印、怎样处理带前缀的环境变量、如何在 pre-commit hook 中集成。
-
更新日志
各发布版本的更新明细、语法解析器优化以及向后兼容性说明。
-
关于与开源许可
开发初衷、代码架构理念,全部基于宽松的 MIT 开源协议发布。