Vue+Vite项目build报错：Property 'env'不存在于ImportMeta类型

以下是针对该问题的具体解决步骤：

1. 修正env.d.ts类型定义 #

你的env.d.ts中直接重定义了ImportMeta的env属性，可能与vite/client内置的类型冲突。修改为扩展ImportMetaEnv来适配Vite的类型系统：

/// <reference types="vite/client" />

// 扩展Vite的环境变量类型，可添加自定义变量（如果有）
interface ImportMetaEnv {
  readonly BASE_URL: string;
  // 示例：readonly VITE_APP_API_URL: string;
}

// 确保ImportMeta的env属性使用扩展后的类型
interface ImportMeta {
  readonly env: ImportMetaEnv;
}

如果不需要自定义环境变量，甚至可以简化为仅保留/// <reference types="vite/client" />，因为Vite已内置BASE_URL等核心变量的类型定义。

2. 检查tsconfig.app.json配置 #

由于项目使用了TypeScript项目引用（Project References），根tsconfig.json的配置不会直接作用于应用代码，需确保tsconfig.app.json包含正确的类型和文件引用：

{
  "extends": "@vue/tsconfig/tsconfig.web.json",
  "include": ["env.d.ts", "src/**/*", "src/**/*.vue"],
  "exclude": ["src/**/__tests__/*"],
  "compilerOptions": {
    "composite": true,
    "types": ["vite/client"]
  }
}

重点确认：

• include数组包含env.d.ts，确保类型文件被正确加载
• compilerOptions.types包含vite/client

3. 清理根tsconfig.json的冗余配置 #

根tsconfig.json作为项目引用的入口，不需要额外的compilerOptions，移除后避免干扰子配置：

{
  "files": [],
  "references": [
    { "path": "./tsconfig.node.json" },
    { "path": "./tsconfig.app.json" },
    { "path": "./tsconfig.vitest.json" }
  ]
}

4. 清除TypeScript缓存 #

类型缓存可能导致旧定义未更新，执行以下命令清除缓存后重新构建：

npx tsc --clearCache
npm run build

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