如何让Parcel.js检测TypeScript的无效导入与类型别名错误

我有一个基础Node.js应用，包含以下文件：

index.html #

<!DOCTYPE html>
<html><head><meta charset="UTF-8">
<script type="module" src="index.ts"></script>
</head><body></body></html>

index.ts #

import { Good } from "./good";
import { Bad } from "./bad";

let test1:Good = {stringVal: "test", numberVal: 1234};
let test2:Good = {stringVal: 1234, numberVal: "test"};
let test3:Good = {};

let test4:Bad = {stringVal: "test", numberVal: 1234};
let test5:Bad = {stringVal: 1234, numberVal: "test"};
let test6:Bad = {};

console.log("Hello world!");

good.ts #

export type Good = {
    stringVal: string;
    numberVal: number;
}

使用ts-node index.ts运行时，能得到预期的错误：

index.ts:2:21 - error TS2307: Cannot find module './bad' or its corresponding type declarations.
index.ts:5:19 - error TS2322: Type 'number' is not assignable to type 'string'.
index.ts:5:36 - error TS2322: Type 'string' is not assignable to type 'number'.
index.ts:6:5 - error TS2739: Type '{}' is missing the following properties from type 'Good': stringVal, numberVal

但使用parcel index.html运行时，未出现任何错误，页面可正常加载，即使存在无效导入、类型不匹配等问题。我推测这是摇树优化导致类型别名被移除，请问如何在Parcel中使用TypeScript类型别名且不被摇树，同时让这些错误被检测到？

1. 启用Parcel的TypeScript类型检查 #

Parcel默认仅转译TypeScript代码，不会强制执行完整的类型检查。在项目根目录创建tsconfig.json，配置严格的类型检查规则：

{
  "compilerOptions": {
    "strict": true,
    "noImplicitAny": true,
    "strictNullChecks": true,
    "strictFunctionTypes": true,
    "strictPropertyInitialization": true,
    "noImplicitReturns": true,
    "noFallthroughCasesInSwitch": true
  },
  "include": ["./**/*"] // 按需调整路径，确保覆盖所有TS文件
}

配置完成后运行parcel index.html，Parcel会调用TypeScript编译器执行类型检查，抛出你预期的错误。

2. 纠正对摇树优化的误解 #

TypeScript类型别名属于编译时概念，转译为JavaScript时会被完全移除，和摇树优化无关。Parcel未报错的核心原因是默认跳过了类型检查，并非摇树删除了类型。只要开启严格的TypeScript配置，类型错误会在编译阶段被检测出来，和代码是否被摇树无关。

3. 处理无效导入问题 #

开启TypeScript检查后，import { Bad } from "./bad"这类无效导入会直接触发TS2307错误，表现和ts-node完全一致，无需额外配置。

4. 开发时强制类型检查 #

若希望Parcel在开发过程中遇到类型错误就终止构建，可添加npm脚本并使用--no-cache参数确保每次构建都重新检查类型：

{
  "scripts": {
    "dev": "parcel index.html --no-cache"
  }
}

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