Nuxt 3 已于 31 July 2026 结束生命周期
此版本将不再接收错误修复或安全补丁。 升级到 Nuxt 4 或获取 HeroDevs 提供的延长支持
运行时配置
了解如何从 Nuxt 2 迁移到 Nuxt 3 的运行时配置。
Geprüfte Übersetzung ·0 % geprüft
如果你希望在 Nuxt 3 应用中引用环境变量，你需要使用运行时配置。
在组件中引用这些变量时，你需要在 setup 方法（或 Nuxt 插件）中使用 useRuntimeConfig 组合式函数。
在应用的 server/ 部分，你可以直接使用 useRuntimeConfig，无需导入。
迁移步骤
- 将应用中使用的所有环境变量添加到
nuxt.config文件的runtimeConfig属性中。 - 将应用的 Vue 部分中所有的
process.env迁移为useRuntimeConfig。
export default defineNuxtConfig({
runtimeConfig: {
// 只在服务器端可用的私有配置
apiSecret: '123',
// public 里的配置也会暴露给客户端
public: {
apiBase: '/api',
},
},
})<script setup lang="ts">
const config = useRuntimeConfig()
// 不再使用 process.env，改为访问 config.public.apiBase
console.log(config.public.apiBase)
</script>export default defineEventhandler((event) => {
const config = useRuntimeConfig(event)
// 在服务器端，可以访问 config.apiSecret 以及 config.public
console.log(config.apiSecret)
console.log(config.public.apiBase)
})# 运行时配置值会在运行时自动被匹配的环境变量替换
NUXT_API_SECRET=api_secret_token
NUXT_PUBLIC_API_BASE=https://nuxtjs.org