Nuxt 3配置报错：类型'NuxtConfig'不存在'runtimeConfig'属性

问题场景 #

按Nuxt3官方流程创建项目后，在nuxt.config.ts中粘贴官方提供的runtimeConfig配置示例，触发如下TypeScript错误：

Argument of type '{ runtimeConfig: { apiSecret: string; public: { apiBase: string; }; }; }' is not assignable to parameter of type 'NuxtConfig'.
  Object literal may only specify known properties, and 'runtimeConfig' does not exist in type 'NuxtConfig'.ts(2345)

使用环境：Node.js 16.16.0、Visual Studio Code

可行解决方案 #

• 确认项目使用Nuxt3版本
  先检查项目中Nuxt的实际版本：

  npm list nuxt
  

  如果版本不是3.x，执行升级命令：

  npm install nuxt@latest --save-dev
  

• 重装依赖更新类型定义
  旧的类型缓存可能引发该问题，按步骤操作：

  1. 删除项目根目录下的node_modules文件夹和package-lock.json（或yarn.lock）文件
  2. 重新安装依赖：

     npm install
     

• 重启VSCode的TypeScript服务
  VSCode的TS服务可能缓存了旧类型信息，按快捷键Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），输入并执行TypeScript: Restart TS Server命令，之后重新检查配置文件。

• 尝试升级Node.js版本
  虽然16.16.0满足Nuxt3最低版本要求（16.11.0+），但升级到Node.js LTS版本（如18.x）可规避潜在的版本兼容问题。

• 临时绕过类型检查（不推荐长期使用）
  若以上方法均无效，可用类型断言临时解决：

  export default defineNuxtConfig({
    runtimeConfig: {
      apiSecret: '123',
      public: {
        apiBase: '/api'
      }
    } as unknown as NuxtConfig
  })
  

内容的提问来源于stack exchange，提问作者voyt97