Nuxt 3 已于 31 July 2026 结束生命周期
此版本将不再接收错误修复或安全补丁。 升级到 Nuxt 4 或获取 HeroDevs 提供的延长支持

运行时配置

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

Geprüfte Übersetzung ·0 % geprüft

使用 runtimeConfig 选项时，必须已配置 nitro。

更新运行时配置

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

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

// 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 的属性下。如果你使用了公共运行时配置，需要更新你的代码。

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