运行时配置 Runtime Config

Nuxt3迁移指南 - 运行时配置

如果您希望在 Nuxt 3 应用程序中引用环境变量,则需要使用运行时配置。

在组件中引用这些变量时,您必须在设置方法(或 Nuxt 插件)中使用 useRuntimeConfig 可组合项。

在应用程序的 server/ 部分,您可以使用 useRuntimeConfig 而无需任何导入。

阅读有关运行时配置的更多信息

迁移步骤

  1. 将您在应用程序中使用的任何环境变量添加到 nuxt.config 文件的 runtimeConfig 属性中。
  2. 在整个应用程序的 Vue 部分将 process.env 迁移到 useRuntimeConfig

示例

ts
nuxt.config.ts
ts
export default defineNuxtConfig({
  runtimeConfig: {
    // 仅在服务器上可用的私有配置
    apiSecret: '123',
    // public 中的配置也会暴露给客户端
    public: {
      apiBase: '/api'
    }
  },
})