目录

什么是 mts 文件

.mts 是 TypeScript 的ES Module 专用扩展名,m 就是 module 的意思。它的作用是:不管当前项目根目录的 package.json 里写没写 “type”: “module”,这个文件都按 ESM(ES 模块) 来处理。

这套扩展名(.mts / .cts)是 TypeScript 4.5 引入的,配套的 Node16 / NodeNext 模块解析在 4.7 定型。

一、和其他扩展名的对应关系

源文件 模块格式 编译后产物 声明文件
.ts 看最近的 package.json:“type”: “module” 是 ESM,否则是 CJS .js .d.ts
.mts 始终是 ESM .mjs .d.mts
.cts 始终是 CommonJS .cjs .d.cts
.mjs / .cjs 这俩是 JavaScript 文件,不是 TS 源文件 — —

记法:m = module(ESM),c = commonjs。.mts 是给 TS 写的,.mjs 是它编译出来的结果。

二、主要特点

三、什么时候用它

四、例子

// src/util.mts
export function greet(name: string): string {
  return `hi ${name}`;
}
export interface User { id: number; name: string; }
 
// src/main.mts
import { greet } from "./util.mjs";        // 注意:写的是编译后的 .mjs
import type { User } from "./util.mjs";    // 只导入类型
 
const user: User = { id: 1, name: "ts" };
const res = await fetch("https://example.com");   // 顶层 await 允许
console.log(greet(user.name), import.meta.url);
// tsconfig.json
{
  "compilerOptions": {
    "target": "es2022",
    "module": "node16",
    "moduleResolution": "node16",
    "outDir": "dist",
    "declaration": true,
    "strict": true
  },
  "include": ["src"]
}

编译与运行:

tsc
node dist/main.mjs

产物是 dist/util.mjs、dist/util.d.mts、dist/main.mjs。

五、常见坑