TypeScript module设为None时编译行为不一致的问题咨询

核心逻辑拆解 #

造成两种编译结果不同的关键在于是否启用多文件合并输出：

1. 直接执行tsc（无--outfile参数）
   此时TypeScript采用「单文件独立编译」模式，每个.ts文件会被单独编译为对应的.js文件。虽然tsconfig里设置了"module": "none"，但这个配置的核心限制是禁止将多个模块合并为单一输出文件，而非完全禁止在单个文件中使用模块语法。
   这种场景下，TypeScript会自动 fallback 到默认的模块输出格式（通常是CommonJS，取决于target配置），所以不会报错，还会生成符合CJS规范的代码。

2. 添加--outfile dist/o.js参数执行编译
   当指定--outfile时，要求TypeScript将所有输入的模块文件打包合并成一个单一输出文件。此时"module": "none"的限制会被严格触发：
   module: none对应的是无模块系统的全局脚本模式，这种模式下代码运行在全局作用域，无法处理import/export的依赖关系，也无法解决多文件合并后的命名冲突问题。因此TypeScript会抛出TS1148错误，明确禁止使用模块语法。

补充说明 #

module: none的设计目标是用于编写全局脚本（比如直接通过浏览器<script>标签引入的代码），这类代码本身就不应该包含模块语法。只有当你尝试将带模块语法的文件合并成单一全局脚本时，TypeScript才会严格校验该配置的限制。

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