在现代Web开发中，管理敏感信息（如API密钥、数据库连接字符串等）是确保应用程序安全性的关键。TypeScript作为JavaScript的超集，提供了静态类型检查和更好的开发体验。本文将介绍如何在TypeScript服务器中使用环境变量来管理这些敏感信息，从而提高应用程序的安全性和可维护性。
为什么使用环境变量？
环境变量是一种存储配置和敏感数据的有效方式。它们可以在不同的部署环境中动态加载，而无需硬编码到源代码中。通过这种方式，可以避免将敏感信息暴露给版本控制系统或第三方服务。环境变量还可以轻松地在不同的开发、测试和生产环境中进行切换，而无需修改代码。
设置环境变量
要开始使用环境变量，首先需要在项目中创建一个`.env`文件。这个文件通常位于项目的根目录下，并且不应该被提交到版本控制系统中（应将其添加到`.gitignore`文件中）。在`.env`文件中，你可以定义键值对形式的环境变量，例如：
DATABASE_URL=mongodb://localhost:27017/mydatabase
JWT_SECRET=your_jwt_secret_key
这些变量将在运行时被读取并加载到Node.js进程中。
安装依赖库
为了在TypeScript项目中读取环境变量，最常用的库是`dotenv`。它可以帮助我们从`.env`文件中加载环境变量到Node.js的`process.env`对象中。我们需要安装`dotenv`：
npm install dotenv
然后，在项目的入口文件（通常是`index.ts`或`app.ts`）顶部添加以下代码：
typescript
import as dotenv from ‘dotenv’;
dotenv.config();
这行代码会告诉`dotenv`从`.env`文件中加载环境变量。
访问环境变量
一旦环境变量被加载到`process.env`中，你就可以在TypeScript代码中像这样访问它们：
typescript
const dbUrl = process.env.DATABASE_URL;
if (!dbUrl) {
throw new Error(‘DATABASE_URL is not set’);
}
console.log(`Connecting to database at ${dbUrl}`);
需要注意的是，环境变量的类型默认为`string | undefined`。在使用之前最好进行类型断言或验证，以确保它们确实存在并且具有正确的格式。
使用类型安全的环境变量
虽然`process.env`可以方便地访问环境变量，但它缺乏类型安全性。为了提供更强的类型检查和自动补全功能，我们可以结合`zod`或`@nestjs/config`等库来定义环境变量的结构和验证规则。
以`zod`为例，首先安装依赖：
npm install zod
接下来，创建一个环境变量验证模式：
typescript
import { z } from ‘zod’;
const envSchema = z.object({
DATABASE_URL: z.string().url(),
JWT_SECRET: z.string().min(1),
});
// 验证环境变量
const parsedEnv = envSchema.parse(process.env);
export const config = {
databaseUrl: parsedEnv.DATABASE_URL,
jwtSecret: parsedEnv.JWT_SECRET,
};
这样做不仅提高了代码的健壮性，还使得编辑器能够更好地理解环境变量的类型，减少了潜在的错误。
通过使用环境变量，我们可以在TypeScript服务器中安全地管理和保护敏感信息。借助`dotenv`库，可以轻松地加载和访问这些变量；而结合`zod`等工具，则可以进一步增强代码的类型安全性和可维护性。遵循这些最佳实践，可以帮助你在构建可靠且安全的应用程序时更得心应手。
