TypeScript未用import/export却自动共享变量是否正常？

问题原因 #

当项目中存在tsconfig.json时，TypeScript会将所有匹配规则的.ts文件视为同一全局作用域下的脚本，而非独立模块。因此未使用import/export声明的变量、类、函数会默认暴露在全局作用域中，导致跨文件可直接访问，最终编译后的JS文件在运行时因作用域冲突报错。而无tsconfig.json时，TypeScript默认以单个文件为编译单元，每个文件的成员局限于自身作用域，不会出现共享问题。

解决方案 #

1. 启用moduleDetection: "force"配置（推荐） #

在tsconfig.json的compilerOptions中添加该配置，强制TypeScript将每个文件当作独立模块处理，即使没有import/export语句：

{
  "compilerOptions": {
    "moduleDetection": "force",
    // 保留其他原有配置
  }
}

此配置会让每个TS文件的成员默认处于文件局部作用域，不会全局共享，VS Code也会即时提示未导入的成员无法访问。

2. 手动添加空导出（临时方案） #

若不想修改tsconfig.json，可在每个需要隔离的TS文件末尾添加空导出，将文件转为模块：

// first.ts
let myName: string = 'John Doe';
export {}; // 标记为模块，成员局部化

添加后，该文件的成员不会泄露到全局作用域，其他文件无法直接访问。

3. 精准控制编译范围 #

通过tsconfig.json的include和exclude字段，明确指定需要编译的文件，避免无关文件被纳入全局作用域：

{
  "compilerOptions": { /* 原有配置 */ },
  "include": ["./src/**/*"], // 仅编译src目录下的所有文件
  "exclude": ["node_modules", "dist"]
}

验证效果 #

修改配置后，VS Code会对未导入的跨文件成员报错提示，编译生成的JS文件也不会出现全局变量冲突问题，实现文件间成员的隔离。

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