You need to enable JavaScript to run this app. Next.js构建时如何禁止自动生成tsconfig.json配置文件?
优惠活动
大模型
产品
解决方案
定价
更多

Next.js构建时如何禁止自动生成tsconfig.json配置文件?

问题触发原因

你遇到的自动生成tsconfig.json的行为,是Next.js 10.0.5版本的固定检测逻辑导致的:
当你执行next build src时,Next会把传入的src目录判定为应用根路径,它的TypeScript配置查找逻辑完全以这个目录为起点,不会向上递归查找你项目根目录下已有的配置。一旦检测到src目录下没有tsconfig.json,就会直接在该目录生成一份带默认规则的配置文件。

可落地的解决方法
  • 调整命令执行方式,移除手动传入的src参数
    Next.js 10.x 原生就支持自动识别项目下的src目录作为源码根,会自动查找src/pages、src/app这类符合路由约定的目录,完全不需要手动把路径作为参数传给next命令。你只需要在项目根目录(site文件夹下)直接执行next build,Next就会从当前工作目录(项目根)开始查找已有的tsconfig.json,不会进入src目录触发自动生成逻辑。
  • 显式指定tsconfig路径,跳过自动检测
    如果你的项目目录结构比较特殊,不想调整现有执行命令,可以在项目根目录新增next.config.js,显式声明tsconfig的读取路径,强制覆盖Next的自动查找逻辑:
    // site/next.config.js
    module.exports = {
      typescript: {
        tsconfigPath: './tsconfig.json'
      }
    }
    
    配置生效后,Next会直接读取你指定的根目录tsconfig文件,不会再在自定义的应用根目录下查找、生成新的配置。
  • 轻量临时规避方案
    如果不想改动现有命令和配置文件,可以提前在src目录下新建一份极简的tsconfig.json,写继承根目录配置的内容就行,Next检测到该文件存在就不会触发自动生成:
    // src/tsconfig.json
    {
      "extends": "../tsconfig.json"
    }
    

注意:这个版本的Next自动生成的tsconfig会强制写入"noEmit": true配置,如果你是自定义TypeScript编译规则要输出文件到dist目录,和这个强制规则会产生冲突,更建议用前两种从根上解决的方法。

内容的提问来源于stack exchange,提问作者vlcik

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.08 14:36:01