> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 环境变量

> 为应用列出、添加、替换和删除环境变量。

`app.envs` 暴露了 [`EnvsModule`](https://github.com/squarecloudofc/sdk-api-js/blob/main/src/modules/envs.ts)，它让你管理应用在运行时看到的 `KEY=value` 键值对。

```typescript theme={null}
const app = await api.applications.fetch("abc123def456abc123def456");
app.envs; // EnvsModule
```

每个方法在操作完成后都会解析为完整的环境变量集 —— 所以你总能拿回一个最新的 `{ key: value }` 映射。

## 列出环境变量

```typescript theme={null}
const envs = await app.envs.list();

console.log(envs);
// { DATABASE_URL: "postgres://...", FEATURE_FLAG: "true" }
```

## 添加或更新变量

`app.envs.set(envs)` 将新变量合并到现有集合中。调用中未出现的现有键会被保留。

```typescript theme={null}
await app.envs.set({
    DATABASE_URL: "postgres://...",
    FEATURE_FLAG: "true",
});
```

## 替换整个环境变量集

`app.envs.replace(envs)` 会覆盖每一个变量。任何未列出的变量都会被**移除**。

```typescript theme={null}
await app.envs.replace({
    DATABASE_URL: "postgres://new-host...",
});
// FEATURE_FLAG is now gone
```

传入一个空对象以清除所有变量：

```typescript theme={null}
await app.envs.replace({});
```

## 删除变量

`app.envs.delete(keys)` 移除列出的键。未知的键会被静默忽略。

```typescript theme={null}
await app.envs.delete(["FEATURE_FLAG"]);
```