---
title: "运行时配置"
description: "Nuxt 提供了一个运行时配置 API，用于在应用程序中公开配置和密钥。"
canonical_url: "https://nuxt.zhcndoc.com/docs/4.x/bridge/runtime-config"
---
# 运行时配置

> Nuxt 提供了一个运行时配置 API，用于在应用程序中公开配置和密钥。

::warning
使用 `runtimeConfig` 选项时，必须先配置 [nitro](https://nuxt.zhcndoc.com/docs/4.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.