TS踩坑日记 - 类型“ImportMeta”上不存在属性“env”

问题出现原因:

  • 创建新项目配置请求这块的时候,需要使用到环境变量;
  • Vue3中使用环境变量和Vue2不太一样,需要使用 import.meta.env 去获取,并且对应的文件中必须使用 VITE_ 开头,才能被 import.meta.env 读取到;
  • 在使用的时候,ts文件报红显示 类型"ImportMeta"上不存在属性"env" ;

解决办法:

✅ 方式一

  • 我是使用的 pnpm create vue@latest 这种方式创建的项目,创建好项目之后,在项目的根目录下自带有 env.d.ts文件,在该文件中有这样一段代码:
ts 复制代码
/// <reference types="vite/client" />
  • 如果没有该声明文件的,可以自行创建一个,然后将该代码复制进去,即可解决;
  • 解释 :
    • 这是 ts 中的 三斜线指令;
    • 三斜线指令 :
      • 是包含单个XML标签的单行注释。注释的内容会作为编译器指令使用;
      • 三斜线指令 仅 可放在包含它的文件的最顶端,一个三斜线指令的前面只能出现单行或多行注释,这包括其他的三斜线指令;
      • 如果他们出现一个语句或声明之后,那么它们会被当作普通的单行注释,并不具有特殊的含义;

/// <reference types="..." />

  • 这个指令是用来声明 依赖 的;

  • 一个 /// <reference types="..." />指令则声明了对某个包的依赖。

  • 对这些包的名字的解析与在 import语句里对模块名的解析类似。 可以简单地把三斜线类型引用指令当做 import声明的包。

  • 例如,把 /// <reference types="node" />引入到声明文件,表明这个文件使用了 @types/node/index.d.ts里面声明的名字; 并且,这个包需要在编译阶段与声明文件一起被包含进来。

  • 仅当在你需要写一个d.ts文件时才使用这个指令。

关于TS项目具体的配置,具体请移步至 🎯 TypeScript项目配置;

  • 更加推荐这种方式,默认情况下,Vite 在 vite/client.d.ts 中为 import.meta.env 提供了类型定义。随着在 .env[mode] 文件中自定义了越来越多的环境变量,你可能想要在代码中获取这些以 VITE_ 为前缀的用户自定义环境变量的 TypeScript 智能提示。
  • 要想做到这一点,我们还是需要依赖于 env.d.ts 文件,接着按下面这样增加 ImportMetaEnv 的定义:
ts 复制代码
/// <reference types="vite/client" />

interface ImportMetaEnv {
  readonly VITE_APP_TITLE: string
  // 更多环境变量...
}

interface ImportMeta {
  readonly env: ImportMetaEnv
}

❌ 方式二

  • 修改配置文件:tsconfig.app.json:
  • 如果没有 tsconfig.app.json 文件,可以在 tsconfig.json 中进行修改,是一样的;
相关推荐
陈随易9 小时前
bm2,Node.js 与 Bun 项目部署新选择
前端·后端·程序员
福兮说11 小时前
canvas 旋转图片的六个坑:四角被裁、Math.ceil 多出 1px 黑边、JPG 角发黑、翻转方向反了
前端·javascript·图像处理·canvas
传人once12 小时前
多图片上传预览功能如何写
前端·css·html·jquery·html5
Eric.4613 小时前
Wan‑Animate+MiniMax-H3 本地部署 AI 漫剧流水线:8G 显存动作迁移与动态分镜工程实战
前端·人工智能·comfyui·ai漫剧
库拉镜像AI牛牛14 小时前
短剧内容自动化生产:知漫剧工作室落地教程
大数据·服务器·前端·人工智能·语音识别
律宏阔14 小时前
Flutter 列表图片内存优化:CachedNetworkImage 与 ClipRRect 的取舍
前端·flutter
行者全栈架构师14 小时前
【鸿蒙心迹】相册文搜图工程化落地:HarmonyOS 7.0 端侧 AI 检索全链路实战与 5 个踩坑解法
前端
律宏阔14 小时前
Dart 3 Record:解决 Future.wait 异构返回值的类型问题
前端·flutter
Seraphina3615 小时前
DVWA(XSS Reflected/Stored High,CSRF Low)
前端·xss·csrf
光影少年15 小时前
Taro 是如何解析入口配置 app.config.ts 和页面配置的?
微信小程序·小程序·typescript·reactjs·百度小程序·taro