tsconfig.json核心是按项目目标配置编译与类型检查：用tsc --init初始化，设target/lib/module适配环境，启用strict/esModuleInterop保障类型安全与模块兼容，通过baseUrl/paths支持路径别名，并用extends实现多环境配置拆分。
在 TypeScript 项目中配置 tsconfig.json，核心是明确项目目标（如构建库、开发 Web 应用、写 Node.js 脚本），再按需设置编译选项。默认生成的配置往往过于宽松或不贴合实际场景，容易导致类型检查失效、输出代码不符合预期等问题。
基础配置：从 tsconfig.json 初始化开始
推荐使用 tsc --init 生成初始配置，它会创建一个带大量注释的模板文件。接着根据项目类型删减和调整关键字段：
-
target：决定生成的 JavaScript 版本（如
"ES2020"），需兼容目标运行环境（浏览器或 Node.js） -
lib：显式声明要包含的 DOM、ES 标准库（如
["ES2020", "DOM"]），避免类型缺失 -
module：指定模块系统（
"ESNext"适合现代打包器，"CommonJS"适合 Node.js） -
outDir 和 rootDir：分离源码与输出目录（如
"src"→"dist"），避免污染源码
严格类型检查：启用关键严格选项
TypeScript 的类型安全主要依赖严格模式。建议至少开启以下几项（它们共同构成 "strict": true 的子集）：
Galileo TypeScript sdk
下载
完整的Galileo AI平台 TypeScript/JS SDK 参考，用于评估、观察和保护 GenAI 应用。适用于构建 Node.js 或 TypeScript 项目。
-
strict：一键启用所有严格检查（包括
noImplicitAny、strictNullChecks等） -
skipLibCheck：设为
true可跳过 node_modules 中类型声明的检查，提升编译速度（开发时推荐） -
noEmitOnError：设为
true，确保类型错误时不生成 JS 文件，防止带错代码上线 - esModuleInterop：解决 CommonJS 与 ES 模块互操作问题（尤其在引入第三方库时很关键）
路径别名与模块解析：提升开发体验
大型项目常用路径别名替代冗长相对路径（如 import Button from "@/components/Button"）。需配合以下配置：
立即学习“Java免费学习笔记（深入）”；
-
baseUrl：设为
"./"或"src"，作为路径解析的根目录 -
paths：定义别名映射，例如：
"paths": { "@/*": ["src/*"], "@utils/*": ["src/utils/*"] } - 注意：Webpack/Vite 等打包工具需同步配置
resolve.alias，否则运行时会报错
针对不同环境的配置拆分
生产构建、本地开发、测试可能需要不同行为。推荐用继承方式管理：
- 主配置
tsconfig.json放通用设置（如compilerOptions） - 新建
tsconfig.dev.json，通过"extends": "./tsconfig.json"继承，并覆盖开发专属项（如"sourceMap": true） - 新建
tsconfig.build.json，关闭sourceMap、启用"declaration": true（生成 .d.ts 文件）用于发布库 - 命令行中指定配置：
tsc -p tsconfig.build.json
