You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

React Vite项目中import.meta.env类型未识别的TypeScript错误修复

解决Vite+React中import.meta.env的TypeScript类型错误
  • 首先修改你的vite-env.d.ts文件,使用正确的类型扩展方式:
    替换原有代码为:

    /// <reference types="vite/client" />
    
    interface ImportMetaEnv {
      readonly VITE_VARIABLE: string;
      // 按需添加其他你用到的VITE_开头的环境变量
      // readonly VITE_API_BASE_URL: string;
    }
    
    interface ImportMeta {
      readonly env: ImportMetaEnv;
    }
    

    开头的/// <reference types="vite/client" />是关键,它会引入Vite自带的类型定义,让你的自定义类型和默认类型合并,而非覆盖原有定义。

  • 检查tsconfig.json配置,确保include数组包含vite-env.d.ts文件,保证TypeScript能识别到这个类型定义:

    {
      "compilerOptions": {
        // 你的其他编译配置
      },
      "include": [
        "src/**/*",
        "vite-env.d.ts" // 如果文件放在src目录下,路径改为"src/vite-env.d.ts"
      ]
    }
    
  • 重启VS Code的TypeScript服务:
    按下Ctrl+Shift+P(Windows)或Cmd+Shift+P(Mac),输入TypeScript: Restart TS Server并执行,清除类型服务缓存。

完成以上操作后,VS Code会正确识别import.meta.env的类型,不再标红报错,同时还能为自定义环境变量提供类型提示。

内容的提问来源于stack exchange,提问作者afriedman111

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.01 05:39:55