如何通过配置文件禁用TypeScript编译器的美化打印功能？

问题场景 #

我编写了一个存在语法错误的TypeScript文件hello.ts：

console.log("Hello World"

项目的package.json依赖了TypeScript 5.2.2：

{
  "dependencies": {
    "typescript": "^5.2.2"
  }
}

同时配置了tsconfig.json，并在compilerOptions中设置"pretty": false：

{
  "compilerOptions": {
    "preserveConstEnums": true,
    "strictNullChecks": false,
    "sourceMap": true,
    "allowJs": true,
    "target": "es6",
    "outDir": ".build",
    "moduleResolution": "node",
    "lib": ["es2022"],
    "rootDir": "./",
    "experimentalDecorators": true,
    "module": "commonjs",
    "pretty": false
  }
}

按照官方文档，该配置应该关闭错误输出的美化，但执行tsc hello.ts时仍得到美化后的错误：

12:17:39:~/hello  $ tsc hello.ts
hello.ts:2:1 - error TS1005: ')' expected.

2 
  


Found 1 error in hello.ts:2

而使用命令行参数--pretty false时，能正确禁用美化：

12:17:53:~/hello  $ tsc --pretty false hello.ts
hello.ts(2,1): error TS1005: ')' expected.

请问如何让tsconfig.json中的pretty: false配置生效？

解决方案 #

问题核心：当直接给tsc指定单个文件（如tsc hello.ts）时，TypeScript会自动忽略tsconfig.json，进入"单文件一次性编译"模式。要让配置生效，可通过两种方式实现：

方法1：不指定具体文件，直接执行编译 #

直接运行：

tsc

此时TypeScript会自动读取当前目录的tsconfig.json，其中的pretty: false配置会生效，输出无美化的错误信息。

方法2：显式指定配置文件+目标文件 #

如果需要编译特定文件同时使用tsconfig.json的配置，用--project（简写-p）参数指定配置文件：

tsc -p tsconfig.json hello.ts

执行后错误输出会和使用--pretty false参数时一致：

hello.ts(2,1): error TS1005: ')' expected.

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