Vite创建的TS项目中两个tsconfig共享代码报错解决方案咨询

安全阿岳

2026-8-26

解决Vite TS项目中两个tsconfig共享代码的冲突问题

问题根源

TypeScript的**项目引用（Project References）**机制要求单个文件只能归属于一个TS项目。当前src/util/env.api.ts同时被tsconfig.json的"include": ["src"]匹配，又被tsconfig.node.json显式包含，导致编译冲突。

解决方案

1. 排除重复包含的文件

修改tsconfig.json，添加exclude规则，把env.api.ts从浏览器端项目中排除，确保它只属于Node端项目：

// tsconfig.json
{
  …
  "include": ["src"],
  "exclude": ["src/util/env.api.ts"],
  "references": [{ "path": "./tsconfig.node.json" }],
  …
}

2. 拆分共享逻辑（如果浏览器端也需要使用）

如果浏览器端代码也需要用到env.api.ts里的逻辑，不要让同一个文件跨项目使用，而是抽离共享部分：

创建src/shared/env.ts，存放两端通用的逻辑，仅被tsconfig.json包含
在src/util/env.api.ts中导入src/shared/env.ts，供Node端（如Vite配置）调用
这样两个项目各自管理自己的文件，避免冲突

3. 确保Node端配置的复合模式开启

tsconfig.node.json需要开启composite: true（Vite生成的默认配置通常已包含），让TS正确处理项目依赖：

// tsconfig.node.json
{
  "compilerOptions": {
    "composite": true,
    … // 其他Node环境配置
  },
  "include": ["vite.config.ts", "./src/vite-env.d.ts", "./src/util/env.api.ts"]
}