typescript:导入模块

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版
前一修订版
typescript:导入模块 [2026/10/10 23:19] – 练习题一节顺延编号为 8 张叶安typescript:导入模块 [2026/10/10 23:25] (当前版本) – 思维导图补充默认导出相关要点 张叶安
行 124: 行 124:
   * 不确定 → 先 ''import * as ns'' 取回来,再 ''ns.'' 点一下,编辑器会列出所有可用名字   * 不确定 → 先 ''import * as ns'' 取回来,再 ''ns.'' 点一下,编辑器会列出所有可用名字
  
-**6. ''node:'' 前缀是什么?怎么查看 ''node:path'' 的源码?**+**6. 默认导出只能有一个吗?** 
 + 
 +**是的,一个模块最多只能有一个默认导出。** 道理很简单:默认导出本质上就是名为 ''default'' 的一个**普通导出名**,而同一个导出名在一个模块里不能重复声明。 
 + 
 +<code typescript> 
 +// ✅ 合法:1 个默认导出 + 任意多个命名导出 
 +export default class Logger {} 
 +export const VERSION = "1.0.0"; 
 +export function log(msg: string) { console.log(msg); } 
 + 
 +// ❌ 解析阶段就报错:Duplicate export of 'default' 
 +export default class A {} 
 +export default class B {} 
 +</code> 
 + 
 +报错信息长这样(Node、浏览器原生 ESM、Vite 都会报同样的错): 
 + 
 +<code> 
 +SyntaxError: Duplicate export of 'default' 
 +</code> 
 + 
 +**下面这些写法其实都是在做"默认导出",彼此冲突:** 
 + 
 +^ 写法 ^ 是不是默认导出 ^ 
 +| ''export default function f() {}'' | ✅ 是 | 
 +| ''export default class C {}'' | ✅ 是 | 
 +| ''export default { a: 1 }'' | ✅ 是(默认导出一个对象字面量) | 
 +| ''export default 42'' | ✅ 是(可以是任意表达式的值) | 
 +| ''export { f as default }'' | ✅ 是,等价写法 | 
 +| ''export const f = 1'' | ❌ 不是,是命名导出 ''f'' | 
 + 
 +所以下面这种混用会**报错**,是很常见的坑: 
 + 
 +<code typescript> 
 +// ❌ 两种默认导出的写法混用 
 +export default function main() {} 
 +export { helper as default };     // Duplicate export of 'default' 
 +</code> 
 + 
 +**几个容易搞混的细节:** 
 + 
 +  * **''import X from "m"'' 完全等价于 ''import { default as X } from "m"''**。也就是说默认导出不是什么特殊机制,只是名字固定叫 ''default'' 的命名导出,导入时可以省掉花括号、随便改名。 
 +  * ''export default function foo() {}'' 里的名字 ''foo'' **只在模块内部可见**,对外一律叫 ''default'';别人写 ''import bar from "m"'' 拿到的名字就是 ''bar''。别指望导入方能用 ''foo''。 
 +  * 匿名默认导出合法且常见:''export default function () {}''、''export default class {}'' 都行;但报错堆栈里会显示成 ''default'',不利于排查,所以建议起个名字。 
 +  * **''export default'' 后跟表达式时导出的是"值快照"**:''let n = 1; export default n;'' 之后再改 ''n'',外部拿到的仍然是 1。想要"活的绑定",得用 ''export { n as default }''(但不能和上面的 ''export default'' 同时出现)。 
 +  * **CommonJS 没有"默认导出"这个概念**,''module.exports'' 整体被 Node 当成默认导出,这正是上一节 ''import fs from "node:fs"'' 能成立的原因。 
 +  * **类型也能默认导出**:''export default interface User {}'';开启 ''--verbatimModuleSyntax'' 后导入要写成 ''import type User from "./types"''。 
 + 
 +**实践建议:** 库通常优先用命名导出(便于 tree-shaking、改名、自动补全),只有"一个模块就一个主功能"时才用默认导出(例如组件文件 ''export default MyComponent'')。两者混用没问题,但**一个模块里绝不能出现两个默认导出**。 
 + 
 +**7. ''node:'' 前缀是什么?怎么查看 ''node:path'' 的源码?**
  
 **为什么要写''node:''** **为什么要写''node:''**
行 173: 行 223:
 前四个是把模块**整体**拿进来(拿到的是带各种方法的对象),最后一个是从 ''url'' 模块里**按名字挑一个函数**,所以带花括号。 前四个是把模块**整体**拿进来(拿到的是带各种方法的对象),最后一个是从 ''url'' 模块里**按名字挑一个函数**,所以带花括号。
  
-**7. 注意事项**+**8. 注意事项**
  
   * `import` / `export` 必须写在**模块顶层**,不能放进函数或 `if` 里(`import()` 动态导入除外)。   * `import` / `export` 必须写在**模块顶层**,不能放进函数或 `if` 里(`import()` 动态导入除外)。
行 182: 行 232:
   * 默认导出和命名导出可以同时用,但一个模块只能有一个默认导出。   * 默认导出和命名导出可以同时用,但一个模块只能有一个默认导出。
  
-**8. 练习题**+**9. 练习题**
  
 **练习 1** **练习 1**
行 245: 行 295:
 export type { User } from "./user"; export type { User } from "./user";
 </code> </code>
 +
 +```mdk height=480 color=#0ea5e9
 +# ES 模块 import / export
 +
 +## 导出
 +### 命名导出
 +- `export const / function / class`
 +- 一个文件可以有多个
 +### 默认导出
 +- `export default ...`
 +- 一个模块只能有一个
 +- 对外名字固定是 `default`
 +- `import X from "m"` ≡ `import { default as X } from "m"`
 +- 重复声明报 `Duplicate export of 'default'`
 +- `export { f as default }` 也算默认导出
 +### 类型导出
 +- `export type { Point }`
 +
 +## 导入
 +### 不带花括号 `import X from`
 +- 取默认导出
 +- 名字自己起
 +### 带花括号 `import { a, b } from`
 +- 取命名导出
 +- 名字必须与导出一致
 +- 可 `as` 改名
 +- 利于 tree-shaking
 +### `import * as ns`
 +- 整体命名空间
 +- `ns.a`、`ns.default`
 +### `import "./x"`
 +- 只执行副作用
 +### `import type { T }`
 +- 只导入类型,编译后擦除
 +### 动态导入
 +- `await import("./x")`
 +- 按需加载 / 代码分割
 +
 +## 内置模块的兼容
 +### Node 内置模块底层是 CommonJS
 +### `module.exports` 被当成默认导出
 +### TS 开关 `esModuleInterop`
 +### 所以 `import fs from "node:fs"` 可用
 +
 +## node: 前缀
 +### 明确指向内置模块
 +### 不会去 node_modules 找同名包
 +### Node 14.18 / 16 起支持
 +### 只能用于内置模块
 +
 +## 查看 node:path
 +### 看接口
 +- 装 `@types/node`
 +- Ctrl+点击 → `@types/node/path.d.ts`
 +### 看实现
 +- GitHub `nodejs/node` 的 `lib/path.js`
 +- `fs`/`crypto`/`zlib` 是 C++ 包装,实现看 `src/`
 +### 列模块名
 +- `node -p "require('node:module').builtinModules"`
 +```
  

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • typescript/导入模块.1791645570.txt.gz
  • 最后更改: 2026/10/10 23:19
  • 由 张叶安