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的自动查找逻辑:
配置生效后,Next会直接读取你指定的根目录tsconfig文件,不会再在自定义的应用根目录下查找、生成新的配置。// site/next.config.js module.exports = { typescript: { tsconfigPath: './tsconfig.json' } } - 轻量临时规避方案
如果不想改动现有命令和配置文件,可以提前在src目录下新建一份极简的tsconfig.json,写继承根目录配置的内容就行,Next检测到该文件存在就不会触发自动生成:// src/tsconfig.json { "extends": "../tsconfig.json" }
注意:这个版本的Next自动生成的tsconfig会强制写入
"noEmit": true配置,如果你是自定义TypeScript编译规则要输出文件到dist目录,和这个强制规则会产生冲突,更建议用前两种从根上解决的方法。
内容的提问来源于stack exchange,提问作者vlcik
相关产品推荐
相关产品推荐

