未编写React代码却触发React相关TSC编译错误的求助

看起来你遇到的问题有点棘手——哪怕清空TS文件还是会抛出相同的10个错误，这说明问题根本不在你的代码本身，大概率是全局配置或者TypeScript的自动配置查找机制在搞鬼。我来帮你一步步排查解决：

可能的原因及对应方案 #

1. 上级目录的全局配置干扰 #

TypeScript有个自动查找规则：会从当前项目目录向上递归搜索tsconfig.json，直到系统根目录。如果你的父文件夹（比如用户主目录、硬盘根目录下的某个文件夹）存在tsconfig.json，它会被自动应用到当前项目，哪怕你本地没配置。

解决步骤：

• 在项目根目录生成专属的本地配置文件：

  npx tsc --init
  

• 打开生成的tsconfig.json，调整几个关键配置：
  • 把noEmitOnError设为true（默认是false，这就是报错还能生成文件的核心原因），这样编译出错时就不会产出文件了
  • 明确include范围，比如设置为["index.ts"]，只编译当前项目的文件
  • 确保exclude包含["node_modules"]，避免编译无关依赖

2. 全局tsc版本与项目本地版本冲突 #

你用了npx tsc index.ts，但有时候npx可能优先调用全局安装的tsc（如果之前装过），而全局版本的配置和项目本地依赖的版本不匹配，就会出现奇怪的错误。

解决步骤：

• 直接调用项目本地的tsc二进制文件，确保用的是项目依赖的版本：

  ./node_modules/.bin/tsc index.ts
  

• 或者用你已经配置好的npm script执行，npm会自动优先使用本地依赖：

  npm run build
  

3. 全局类型定义包的冲突 #

如果你的系统全局安装了某些类型定义包（比如@types/node或其他全局类型），可能会和项目本地的配置冲突，导致无意义的编译错误。

解决步骤：

• 在本地tsconfig.json中添加typeRoots配置，指定只使用项目本地的类型定义：

  "typeRoots": ["./node_modules/@types"]
  

验证方法 #

完成上面的步骤后，清空index.ts再重新编译，如果错误消失，说明问题解决了。如果还有报错，建议把编译时的具体错误信息贴出来，这样能更精准地定位问题。

附：你的原始代码与配置 #

TypeScript代码（index.ts）：

const greeting: string = "Hello world";

console.log(greeting);

package.json：

{  
  "name": "typescript",  
  "version": "1.0.0",  
  "main": "index.js",  
  "author": "ema4hhh",  
  "license": "MIT",  
  "dependencies": {  
    "typescript": "^4.9.4"  
  },  
  "scripts": {  
    "start": "node index.js",  
    "build": "tsc index.ts",  
    "watch": "tsc index.ts -w"  
  }
}

内容的提问来源于stack exchange，提问作者Emanuel Castaño Cardona