tsc因误报import.meta相关错误无法正常生成类型声明文件如何解决

问题根因 #

你遇到的报错是因为直接在tsc命令中指定了单个入口文件src/index.ts，此时tsc不会主动加载工作区内其他自定义声明文件（包括你写的src/ImportMeta.d.ts）。VS Code没有报错是因为IDE默认会扫描整个工作区的所有类型声明文件并加载，和命令行调用tsc的逻辑不一致。
而报错仍生成声明文件是tsc的默认行为：只要代码语法没有致命错误，即使类型检查不通过，也会完成输出，只有添加--noEmitOnError参数时才会在出错时终止生成。

解决方案 #

方案1：使用tsconfig.json管理配置（推荐）

在项目根目录的tsconfig.json中添加如下配置：

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "ES2020",
    "outDir": "dist/types",
    "emitDeclarationOnly": true,
    // 可选：直接使用Vite官方提供的env类型定义，无需自己写ImportMeta.d.ts
    "types": ["vite/client"]
  },
  // 包含src下所有文件，会自动加载目录内的d.ts声明
  "include": ["src/**/*"]
}

之后直接执行npx tsc即可完成类型构建，不会再报错。如果使用官方的vite/client类型，可以删除你自行编写的ImportMeta.d.ts，避免重复定义冲突。

方案2：命令行手动引入声明文件

如果不想新增/修改tsconfig.json，可以直接在执行tsc时把你的自定义声明文件也传入：

npx tsc src/index.ts src/ImportMeta.d.ts \
    --emitDeclarationOnly \
    --module es2020 \
    --target es2020 \
    --outDir dist/types

这样tsc会加载你写的ImportMeta类型扩展，不会再抛出属性不存在的错误。

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