javascript es modules 与 typescript 配合的核心做法是:在 tsconfig.json 中将 module 设置为 esnext,将 target 设为目标运行环境(如 es2020),并配置 moduleresolution 为 node16 或 bundler。typescript 编译器会保留 import/export 语法不变,直接输出原生 js 模块文件,无需额外转换步骤即可在现代浏览器或 node.js 中运行。

TypeScript 如何配置以输出原生 ES Modules
要确保 TypeScript 输出原生 ES Modules,必须在 tsconfig.json 中明确指定 "module": "ESNext"。这告诉编译器不要将 import/export 转换为 CommonJS 的 require(),而是原样保留。同时,moduleResolution 应设为 "Node16" 或 "Bundler",以正确处理现代模块解析规则。这样生成的 .js 文件可以直接被 Node.js 或浏览器加载。

{
"compilerOptions": {
"target": "ES2020",
"module": "ESNext",
"moduleResolution": "Node16",
"outDir": "./dist",
"rootDir": "./src"
},
"include": ["src/**/*"]
}
上述配置是基础且通用的设置。当 module 为 ESNext 时,TypeScript 不会添加任何模块包装器,输出的代码结构与你编写的源码完全一致。这对于构建库或直接部署到支持 ESM 的环境至关重要。
立即学习“Java免费学习笔记(深入)”;
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
如何处理类型导入与运行时导入的分离
在 ES Modules 环境中,TypeScript 提供了 import type 语法来区分类型导入和值导入。这有助于减少打包体积并确保类型信息不会污染运行时。使用 import type { SomeInterface } 可以在编译时被移除,而 import { someFunction } 则会被保留。这种分离在处理大型项目或避免循环依赖时非常有效。

// types.ts
export interface User {
id: number;
name: string;
}
// service.ts
import type { User } from './types'; // 仅用于类型检查
import { fetchUser } from './api'; // 运行时导入
async function getUser(id: number): Promise<User> {
return await fetchUser(id);
}
在这个例子中,User 接口仅在编译时使用,不会出现在最终的 JavaScript 文件中。而 fetchUser 是一个实际的函数,需要在运行时可用。这种写法符合 ES Modules 的最佳实践,确保了类型安全的同时优化了产物。
当导出默认值与非默认值混合时,导入语句应如何书写
当一个模块同时导出默认值和命名导出时,导入方需要分别处理。例如,一个模块可能默认导出一个主类,同时导出一些辅助函数。在 TypeScript 中,你可以使用 import DefaultExport, { NamedExport } from './module' 的语法来同时获取两者。如果只导入默认值,可以省略花括号;如果只导入命名导出,则必须使用花括号。这种灵活性使得模块设计更加清晰。
// module.ts
export default class MainClass {}
export function helper() {}
// app.ts
import MainClass, { helper } from './module';
const instance = new MainClass();
helper();
这种导入方式在 ES Modules 中是标准的。TypeScript 会正确解析这些导入,并在输出中保持相同的结构。需要注意的是,如果模块没有默认导出,尝试导入默认值会导致编译错误。因此,明确模块的导出策略对于保持代码一致性非常重要。

















