Zod 环境变量集成
提供生成基于 Zod 验证的类型安全环境变量管理代码的指导和模板。包含创建 schema、getter 函数和桶导出的示例和最佳实践。
工作原理
- 在项目根目录准备 .env.example 文件
- 严格参照 best-practice-examples/ 中的代码结构和模式
- 对于单环境：生成
integrations/env/包含 schema、getter 和导出 - 对于多环境：为每个环境生成独立的
integrations/{env}-env/目录 - 按照代码生成指南创建 Zod schema
- 实现带有适当错误处理的 getter 函数
- 创建桶导出以实现干净的导入
- 在应用程序中使用生成的代码
使用方法
此技能提供文档和示例。按照参考指南中的步骤操作：
- 单环境代码生成指南 - 单环境代码生成的详细规则
- 多环境代码生成指南 - 多环境代码生成的详细规则
- .env.example 模板 - .env 文件的模板
- 最佳实践示例 - 必须严格参照的单环境和多环境代码示例
重要： 实现时必须严格遵循 best-practice-examples 中的代码结构、命名约定和错误处理模式。任何修改都可能破坏类型安全保证。
故障排除
- 缺少 .env.example：从 references/.env.example.template 复制模板
- 未安装 Zod：在项目中运行
pnpm install zod - 类型错误：检查代码生成指南中的正确 schema 语法
- 导入错误：确保 index.ts 中的桶导出正确
- 偏离最佳实践：如果遇到问题，首先确认代码结构是否严格遵循 best-practice-examples 中的模式