---
title: "运行时配置"
description: "Nuxt 提供了运行时配置 API，用于在应用程序内暴露配置和密钥。"
canonical_url: "https://nuxt.zhcndoc.com/docs/3.x/bridge/runtime-config"
---
# 运行时配置

> Nuxt 提供了运行时配置 API，用于在应用程序内暴露配置和密钥。

::warning
使用 `runtimeConfig` 选项时，必须已配置 [nitro](https://nuxt.zhcndoc.com/docs/3.x/bridge/nitro)。
::

## 更新运行时配置

Nuxt 3 采用了不同于 Nuxt 2 的运行时配置方式，使用了一个新的合并后的 `runtimeConfig` 选项。

首先，你需要将 `publicRuntimeConfig` 和 `privateRuntimeConfig` 两个属性合并为一个新的 `runtimeConfig`，其中公共配置放在名为 `public` 的键内。

```diff
// nuxt.config.js
- privateRuntimeConfig: {
-   apiKey: process.env.NUXT_API_KEY || 'super-secret-key'
- },
- publicRuntimeConfig: {
-   websiteURL: 'https://public-data.com'
- }
+ runtimeConfig: {
+   apiKey: process.env.NUXT_API_KEY || 'super-secret-key',
+   public: {
+     websiteURL: 'https://public-data.com'
+   }
+ }
```

这也意味着当你需要访问公共运行时配置时，它被放置在名为 `public` 的属性下。如果你使用了公共运行时配置，需要更新你的代码。

```diff
// MyWidget.vue
- <div>Website: {{ $config.websiteURL }}</div>
+ <div>Website: {{ $config.public.websiteURL }}</div>
```


## Sitemap

See the full [sitemap](https://nuxt.zhcndoc.com/sitemap.md) for all pages.