用途:在 Vercel、Convex 等部署平台之间安全设置、检查与核对环境变量,减少因尾部换行、跨平台不一致或格式错误引起的报错和静默失败。触发场景包括 env var、环境变量、生产部署、webhook secret、API key、token、Invalid character in header、ERR_INVALID_CHAR、静默失败、webhook 不工作、Vercel、Convex、secrets 等。
主要能力:一是避免尾部空白,建议用 printf 而非 echo,例如 printf '%s' 'sk_live_xxx' | vercel env add STRIPE_SECRET_KEY production;Convex 可用 bunx convex env set --prod KEY "$(echo 'value' | tr -d '\n')"(或 npx convex ...)。二是跨平台一致性,共享令牌需在 Vercel 与 Convex、前端与后端、各环境间保持一致,可先用 openssl rand -hex 32 生成一次再分别设置。三是格式校验,如 Stripe 密钥模式 sk_(test|live)_[A-Za-z0-9]+ 等。四是区分 Dev 与 Prod,分别用 bunx convex env list --prod 与 vercel env ls --environment=production 验证。五是注意 CLI 陷阱,CONVEX_DEPLOYMENT=prod:xxx 可能仍返回 dev 数据,应改用显式 --prod 标志。六是环境变量加载语义,多数运行时在进程启动时只读一次,修改后须重启。
用法:设置用 vercel env add KEY production 或 bunx convex env set --prod;检查用 vercel env ls 与 bunx convex env list --prod;另可通过循环检查行尾空白、按正则校验密钥格式。
限制:资料未提供具体版本、定价、支持平台清单及错误率等信息;文中提到的相关命令如 /pre-deploy、/env-parity-check、/stripe-check 及 references 目录文件暂未提供详细内容。