能否指定单个TypeScript文件执行tsc时自动加载tsconfig.json？

同一目录下有TypeScript文件index.ts和配置文件tsconfig.json：
index.ts代码：

function foo(bar) {
    bar.buzz = 100;
}

let obj = { x: 0 };
obj.bar = 100;

tsconfig.json配置：

{
    "compilerOptions": {
        "strict": true
    }
}

执行npx tsc -p tsconfig.json时，出现预期的2个错误；但执行npx tsc index.ts时仅出现1个错误。

是否可以执行类似npx tsc index.ts的命令，让tsc自动读取tsconfig.json？如果可以，具体如何操作？如果不行，原因是什么？作为TypeScript新手，想了解其中关联。

查阅TypeScript官方文档后发现，当命令行指定输入文件时，tsconfig.json会被忽略，希望得到资深开发者的确认。

环境版本：

$ node -v
v18.19.0
$ npx tsc -v
Version 5.3.3

系统：MacOS Catalina (10.15.7)

各命令执行输出：

• 执行npx tsc index.ts仅报TS2339错误；
• 执行npx tsc -p tsconfig.json和npx tsc均报TS7006和TS2339两个错误。

你的文档查阅结论是正确的：当在命令行直接指定输入文件（比如npx tsc index.ts）时，TypeScript编译器会完全忽略tsconfig.json。

原因 #

TypeScript的设计逻辑分为两种模式：

• 单次编译模式：当命令行指定具体文件时触发，编译器仅处理你指定的文件，使用默认编译选项（或命令行额外添加的选项），不会读取配置文件。
• 项目模式：不指定具体文件时触发（比如npx tsc或npx tsc -p tsconfig.json），编译器会自动查找并应用tsconfig.json中的所有配置。

你看到的错误差异正源于此：

• npx tsc index.ts用默认选项，未启用strict，所以只检测到obj.bar不存在的TS2339错误；
• strict模式下会额外检测foo函数参数bar无类型注解的TS7006错误，这就是两种命令错误数量不同的核心原因。

替代方案 #

如果想针对单个文件应用tsconfig.json的配置，有两种可行方式：

1. 结合--project与--files参数：
   加载配置文件的同时指定要编译的单个文件，命令如下：

   npx tsc -p tsconfig.json --files index.ts
   

   编译器会读取tsconfig.json的配置，同时仅编译index.ts。
2. 修改tsconfig.json的include字段：
   在配置文件中添加include数组，只包含目标文件：

   {
       "compilerOptions": {
           "strict": true
       },
       "include": ["index.ts"]
   }
   

   之后直接执行npx tsc即可，编译器会加载配置并仅编译index.ts。

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