推荐使用 znv：强大的环境变量解析库

项目介绍

znv 是一个基于 Zod 的环境变量解析工具，它可以将你的环境变量转化为验证过且类型安全的只读对象，适用于 Node.js 应用程序。通过提供清晰的规范和默认值，znv 可以帮助你轻松管理并确保配置的正确性，避免因配置错误导致的问题。

项目技术分析

znv 内部利用了 Zod，一个强大的类型安全的 JSON 数据验证器，对环境变量进行预处理和转换。znv 自定义了一些特别针对环境变量的解析规则，并简化了在 Zod 中为变量设置默认值的过程，尤其是在不同环境（如生产或开发）中。

项目及技术应用场景

1. 应用配置管理 - 在启动应用程序时，可以通过 znv 将环境变量转化为结构化的配置对象，确保这些配置始终符合预期。
2. 安全性提升 - 通过验证和类型检查，znv 可以防止因无效环境变量导致的安全问题，如意外暴露敏感信息。
3. 开发效率优化 - 提供默认值和详细的描述，使得在不同环境中快速切换配置变得简单，减少调试时间。

项目特点

1. 类型安全 - 使用 TypeScript 编写，可以自动推断环境变量的类型，为你的代码提供更好的类型检查。
2. 易于使用 - 提供简单的 parseEnv 函数，接受环境变量和模式定义，返回一个已验证的对象。
3. 默认值管理 - 按照 NODE_ENV 设置不同的默认值，让配置更灵活。
4. 错误提示 - 当环境变量不符合规范时，会提供详细的错误信息，包括错误原因和帮助文本。
5. 自定义解析规则 - 支持自定义 Zod 验证规则，并提供了常见的类型转换助手，如端口解析。

快速上手

npm install znv zod
# 或者
yarn add znv zod

然后创建一个 env.ts 文件：

import { parseEnv, z } from "znv";

const { NICKNAME, LLAMA_COUNT, COLOR, SHINY } = parseEnv(
  process.env,
  {
    NICKNAME: z.string().min(1),
    LLAMA_COUNT: z.number().int().positive(),
    COLOR: z.enum(["red", "blue"]),
    SHINY: z.boolean().default(true),
  }
);

console.log([NICKNAME, LLAMA_COUNT, COLOR, SHINY].join(", "));

运行这个文件，znv 就会帮你验证并解析环境变量。

通过 znv，你可以实现一个整洁、可维护且强类型的环境变量管理系统，为你的 Node.js 项目添加一层额外的安全保障。现在就尝试一下 znv 吧，看看它能如何提升你的项目质量！