环境变量由 Vite 加载的 [从](https://vitejs.dev/guide/env-and-mode.html#env-files) `.env` 文件和 `process.env` 中，类似于 [`$env/dynamic/private`](/docs/kit/$env-dynamic-private)，此模块不能导入到客户端代码中。此模块仅包括不以 *不* 以 [`config.kit.env.publicPrefix`](/docs/kit/configuration#env)*和* 以 [`config.kit.env.privatePrefix`](/docs/kit/configuration#env)（如果已配置）开头的变量。

与*不同于*[`$env/dynamic/private`](/docs/kit/$env-dynamic-private)不同，此模块导出的值在构建时静态注入到您的包中，从而启用诸如死代码消除等优化。

```ts
import { API_KEY } from '$env/static/private';
```

请注意，您代码中引用的所有环境变量都应声明（例如在 `.env` 文件中），即使它们在应用部署之前没有值：

```
MY_FEATURE_FLAG=""
```

您可以通过命令行像这样覆盖`.env`的值：

```bash
MY_FEATURE_FLAG="enabled" npm run dev
```