TypeScript 包管理：package.json 与 tsconfig.json

TypeScript 项目的核心在于两个配置文件：package.json 负责项目的依赖管理和脚本定义，tsconfig.json 负责 TypeScript 编译器的行为控制。理解并正确配置这两个文件，是搭建稳健开发环境的第一步。

1. 配置 package.json：管理依赖与脚本

package.json 是项目的身份证，它记录了项目名称、版本以及运行所需的第三方库。

打开 终端，进入 项目根目录，执行 以下命令初始化文件：

npm init -y

编辑 生成的 package.json 文件，重点关注以下字段。

1.1 核心依赖字段

区分 dependencies 和 devDependencies 是项目规范的关键。

安装 生产环境依赖（例如 express）：

npm install express

安装 开发环境依赖（例如 typescript）：

npm install -D typescript

1.2 脚本命令 (scripts)

scripts 字段定义了快捷命令，简化复杂的终端操作。

修改 package.json 中的 scripts 部分：

{
  "scripts": {
    "build": "tsc",
    "start": "node dist/index.js",
    "dev": "ts-node src/index.ts"
  }
}

运行 编译命令时，只需 输入：

npm run build

2. 配置 tsconfig.json：控制编译行为

tsconfig.json 是 TypeScript 编译器的指南针，告诉它如何将 .ts 代码转换为 .js 代码。

运行 以下命令生成基础配置文件：

npx tsc --init

打开 tsconfig.json，调整 以下关键配置项以适应现代开发需求。

2.1 编译选项

以下选项决定了编译产物的规范和严格程度。

配置 示例如下：

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "outDir": "./dist",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules"]
}

2.2 文件包含与排除

明确告诉编译器哪些文件需要处理，哪些需要忽略。

设置 include 字段，指定 需要编译的文件路径：

"include": ["src/**/*"]

设置 exclude 字段，排除 不需要编译的目录：

"exclude": ["node_modules", "dist"]

3. 协同工作：构建完整流程

将两个文件结合使用，即可实现从编写代码到打包运行的全自动化流程。当你在终端 执行 npm run build 时，系统会按照既定逻辑运行。

以下是该过程的执行逻辑流：

为了确保上述流程顺畅，请按以下步骤 检查 项目结构：

1. 创建 src 目录，并在其中 编写 index.ts 文件。
2. 确认 tsconfig.json 中的 rootDir 指向 src。
3. 确认 tsconfig.json 中的 outDir 指向 dist。
4. 在 package.json 中 添加 "build": "tsc"。
5. 运行 npm run build。
6. 查看 dist 目录是否生成了对应的 .js 文件。