tsconfig.json使用extends字段未生效，仅加载基础配置问题求助

嘿，我来帮你捋一捋这个拆分TS配置后extends失效的问题！这种场景我之前踩过不少坑，大概率是下面几个地方出了问题：

1. 相对路径写错了（最常见） #

extends字段里的路径是相对于当前配置文件的相对路径，很多人容易在这里出错。比如：

• 如果你的测试配置文件tsconfig.test.json和基础tsconfig.json都在根目录，那extends应该写"./tsconfig.json"
• 如果测试配置放在tests/文件夹里，就得写成"../tsconfig.json"

路径写错的话，TS根本找不到基础配置，自然只会加载默认的根目录配置。

2. 子配置文件结构错误 #

子配置必须保持正确的TSConfig结构，不能把compilerOptions写成顶级字段，也不能遗漏关键结构。比如你的测试配置应该是这样的：

{
  "extends": "./tsconfig.json",
  "compilerOptions": {
    // 这里写测试环境特有的配置，比如调整types、sourceMap之类的
    "types": ["jest"] // 如果基础配置已经包含jest，这里可以省略
  },
  "include": ["tests/**/*"] // 必须指定测试文件的范围，不然TS不知道要处理哪些文件
}

另外要注意：子配置里的include/exclude会覆盖基础配置的对应字段，所以如果测试需要引用src里的代码，记得把src/**/*也加到include里。

3. 工具链没指定正确的配置文件 #

你说“仅基础tsconfig.json被加载”，很可能是你的测试工具（比如Jest）或者编辑器没被配置成使用测试用的TSConfig：

• 如果用Jest，要在jest.config.js里设置：

  module.exports = {
    // ...其他配置
    globals: {
      'ts-jest': {
        tsconfig: './tsconfig.test.json'
      }
    }
  };
  

• 如果用VS Code，可以在.vscode/settings.json里指定测试文件对应的TSConfig，让编辑器识别到不同文件用不同配置。

4. TypeScript版本过低 #

extends字段是在TypeScript 3.2版本才正式支持的，如果你的TS版本低于3.2，这个字段根本不会生效。你可以运行tsc --version检查下版本，要是低于3.2，赶紧升级到最新稳定版。

验证方法 #

最直接的验证方式是运行这个命令，查看最终生效的配置：

tsc --project tsconfig.test.json --showConfig

如果输出里包含基础配置的内容（比如lib、module这些），说明extends生效了；如果没有，那就是前面的某个步骤出了问题。

给你一个完整的拆分示例参考：

基础配置（tsconfig.json） #

{
  "compileOnSave": true,
  "compilerOptions": {
    "lib": ["es2017"],
    "module": "commonjs",
    "noImplicitReturns": true,
    "removeComments": true,
    "target": "es6",
    "types": ["node", "express", "electron", "cors"],
    "noUnusedLocals": true
  },
  "include": ["src/**/*"]
}

测试配置（tsconfig.test.json） #

{
  "extends": "./tsconfig.json",
  "compilerOptions": {
    "types": ["jest", "node", "express", "electron", "cors"] // 保留基础类型，追加jest
  },
  "include": ["tests/**/*", "src/**/*"] // 包含测试文件和源码，避免测试时找不到模块
}

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