envfile-checker 0.1.0

Check .env files for missing variables, placeholders, and sensitive data

env-checker 🔍

检查 .env 文件的健康状态：缺失变量、占位符、敏感信息、格式问题。

痛点

• 部署时忘记更新 .env，服务挂了
• .env.example 和 .env 不同步，新成员 onboard 出问题
• 敏感信息误提交到 git
• 占位符忘记替换

安装

pip install env-checker

使用

# 分析单个文件
env-checker .env

# 比较两个文件（检查缺失变量）
env-checker .env .env.example

# 检查目录中所有 .env 文件
env-checker --dir ./myproject

# JSON 格式输出（方便脚本处理）
env-checker .env --json

示例输出

📊 分析: .env
============================================================
📝 总变量数: 12

⚠️  空值变量 (2):
   • DATABASE_URL
   • REDIS_URL

📌 占位符变量 (1):
   • API_KEY (your-api-key-here)

🔐 敏感变量 (3):
   • SECRET_KEY: a1b2c3d4e5f6...
   • AWS_SECRET_ACCESS_KEY: AKIA...
   • JWT_SECRET: eyJhbGciOi...

✅ 格式检查通过

比较模式

📊 比较: .env.example vs .env
============================================================

❌ .env 中缺失的变量:
   • NEW_FEATURE_FLAG
   • ANALYTICS_KEY

⚠️  .env.example 中缺失的变量:
   • DEBUG_MODE

🔄 值不同的变量:
   • NODE_ENV

功能

功能	说明
缺失检测	比较两个文件，找出缺失的变量
占位符检测	找出 your-xxx、changeme、TODO 等占位符
敏感信息检测	找出 password、secret、token 等敏感变量
空值检测	找出没有赋值的变量
格式检查	检查变量名格式、特殊字符转义

CI/CD 集成

# GitHub Actions
- name: Check env files
  run: |
    pip install env-checker
    env-checker .env.example .env.production --json > env-report.json

License

MIT - Built by IndieKit