JavaScript/TypeScript文件扩展名是否无限制？特殊扩展名解析

1. 文件扩展名是否存在限制？ #

从操作系统层面来说，只要文件名符合系统命名规则（比如不能包含 /、\、: 等特殊字符），你可以给JS/TS文件使用任意自定义扩展名。但从工具链（TypeScript编译器、Node.js、打包工具、编辑器等）的角度，只有被工具识别的扩展名才能被正确处理——未被识别的扩展名可能会导致编译报错、无法被Node.js加载，或者编辑器失去语法提示。

比如TypeScript默认只识别 .ts、.d.ts、.tsx、.mts、.cts 等扩展名；Node.js默认只处理 .js、.mjs、.cjs、.json 等扩展名。如果用了自定义扩展名（比如 .foo.ts），需要手动配置工具（比如在tsconfig.json的include里指定，或者在Node.js的package.json里配置exports），才能让工具正确解析。

2. 扩展名会改变文件的处理方式吗？ #

会，不同的扩展名会让编译器、引擎或工具对文件采取不同的处理逻辑，举几个常见例子：

TypeScript 相关 #

• .ts：标准TypeScript源码文件，编译时会被转换为JavaScript输出，同时进行类型检查。
• .d.ts：仅包含类型声明的文件（类型定义文件），TS编译器会读取其中的类型信息用于类型检查，但不会生成对应的JavaScript文件。常用于给JS库补充类型，或者共享项目内的类型定义。
• .tsx：支持JSX语法的TypeScript文件，React、SolidJS等框架项目常用，编译时会将JSX标签转换为对应的渲染函数调用。
• .mts/.cts：分别对应ES模块和CommonJS模块的TypeScript文件，编译后会生成.mjs/.cjs格式的JS文件，不受package.json中type字段的影响。

Node.js 相关 #

• .js：模块格式由package.json的type字段决定——如果type是module则按ES模块处理，是commonjs则按CommonJS处理。
• .mjs：强制作为ES模块处理，不管package.json的type字段是什么。
• .cjs：强制作为CommonJS模块处理，不受package.json的type字段影响。

自定义扩展名的场景 #

像.route.ts、.schema.ts这类带后缀的自定义扩展名，本身不会改变TypeScript的编译行为，但可以让工具（比如ESLint、VS Code、打包工具）识别文件用途，应用特定规则：

• 比如在ESLint中配置overrides，给.route.ts文件启用路由相关的lint规则；
• 在VS Code中通过配置，让.schema.ts文件自动关联JSON Schema校验；
• 在Webpack/Vite中配置扩展名解析规则，确保这些文件能被正确打包。

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