SuperAPI AI 工具集

env-setup-wizard

通用与其它

查看项目

更新于 10-16 02:38

技能介绍

用途:在项目搭建阶段统一处理环境变量与配置文件,覆盖从变量梳理到文档化的完整流程。

主要能力与做法:先识别项目所需变量,再按应用、数据库、认证、第三方 API、存储等分组创建 .env 结构;提供 .env、.env.example、.env.local、.env.development、.env.production 等文件布局,.env.example 作为提交到 Git 的模板,并给出 .gitignore 规则(忽略 .env、.env.local、.env.*.local,保留 .env.example)。

类型安全与校验:通过 src/lib/env.ts 结合 Zod 定义 schema,对 NODE_ENV、APP_URL、PORT、DATABASE_URL、JWT_SECRET、NEXTAUTH_SECRET、NEXTAUTH_URL 等进行类型与长度校验,导入时 safeParse,失败输出字段错误并 process.exit(1),导出 env 与 Env 类型。Next.js 场景区分服务端与客户端变量(客户端需 NEXT_PUBLIC_ 前缀),并提到可选使用 T3 Env 的 createEnv 方式定义 server、client、runtimeEnv。

安全实践:不提交密钥、按环境使用不同值、定期轮换、生产环境使用 Vault 或 AWS Secrets Manager 等密钥管理器、启动时校验以快速失败,并遵循 NEXT_PUBLIC_、VITE_、REACT_APP_ 等客户端前缀约定。

限制:资料未提供具体命令安装步骤、价格、支持平台及版本要求,暂未提供。