差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
| typescript:导入模块 [2026/10/10 23:19] – 新增「为什么有的导入带花括号」与「node: 前缀 / 如何查看 node:path 源码」两节 张叶安 | typescript:导入模块 [2026/10/10 23:25] (当前版本) – 思维导图补充默认导出相关要点 张叶安 | ||
|---|---|---|---|
| 行 124: | 行 124: | ||
| * 不确定 → 先 '' | * 不确定 → 先 '' | ||
| - | **6. '' | + | **6. 默认导出只能有一个吗?** |
| + | |||
| + | **是的,一个模块最多只能有一个默认导出。** 道理很简单:默认导出本质上就是名为 '' | ||
| + | |||
| + | <code typescript> | ||
| + | // ✅ 合法:1 个默认导出 + 任意多个命名导出 | ||
| + | export default class Logger {} | ||
| + | export const VERSION = " | ||
| + | export function log(msg: string) { console.log(msg); | ||
| + | |||
| + | // ❌ 解析阶段就报错:Duplicate export of ' | ||
| + | export default class A {} | ||
| + | export default class B {} | ||
| + | </ | ||
| + | |||
| + | 报错信息长这样(Node、浏览器原生 ESM、Vite 都会报同样的错): | ||
| + | |||
| + | < | ||
| + | SyntaxError: | ||
| + | </ | ||
| + | |||
| + | **下面这些写法其实都是在做" | ||
| + | |||
| + | ^ 写法 ^ 是不是默认导出 ^ | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | |||
| + | 所以下面这种混用会**报错**,是很常见的坑: | ||
| + | |||
| + | <code typescript> | ||
| + | // ❌ 两种默认导出的写法混用 | ||
| + | export default function main() {} | ||
| + | export { helper as default }; // Duplicate export of ' | ||
| + | </ | ||
| + | |||
| + | **几个容易搞混的细节:** | ||
| + | |||
| + | * **'' | ||
| + | * '' | ||
| + | * 匿名默认导出合法且常见:'' | ||
| + | * **'' | ||
| + | * **CommonJS 没有" | ||
| + | * **类型也能默认导出**:'' | ||
| + | |||
| + | **实践建议:** 库通常优先用命名导出(便于 tree-shaking、改名、自动补全),只有" | ||
| + | |||
| + | **7. '' | ||
| **为什么要写'' | **为什么要写'' | ||
| 行 173: | 行 223: | ||
| 前四个是把模块**整体**拿进来(拿到的是带各种方法的对象),最后一个是从 '' | 前四个是把模块**整体**拿进来(拿到的是带各种方法的对象),最后一个是从 '' | ||
| - | **7. 注意事项** | + | **8. 注意事项** |
| * `import` / `export` 必须写在**模块顶层**,不能放进函数或 `if` 里(`import()` 动态导入除外)。 | * `import` / `export` 必须写在**模块顶层**,不能放进函数或 `if` 里(`import()` 动态导入除外)。 | ||
| 行 182: | 行 232: | ||
| * 默认导出和命名导出可以同时用,但一个模块只能有一个默认导出。 | * 默认导出和命名导出可以同时用,但一个模块只能有一个默认导出。 | ||
| - | **6. 练习题** | + | **9. 练习题** |
| **练习 1** | **练习 1** | ||
| 行 245: | 行 295: | ||
| export type { User } from " | export type { User } from " | ||
| </ | </ | ||
| + | |||
| + | ```mdk height=480 color=# | ||
| + | # ES 模块 import / export | ||
| + | |||
| + | ## 导出 | ||
| + | ### 命名导出 | ||
| + | - `export const / function / class` | ||
| + | - 一个文件可以有多个 | ||
| + | ### 默认导出 | ||
| + | - `export default ...` | ||
| + | - 一个模块只能有一个 | ||
| + | - 对外名字固定是 `default` | ||
| + | - `import X from " | ||
| + | - 重复声明报 `Duplicate export of ' | ||
| + | - `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 " | ||
| + | - 只执行副作用 | ||
| + | ### `import type { T }` | ||
| + | - 只导入类型,编译后擦除 | ||
| + | ### 动态导入 | ||
| + | - `await import(" | ||
| + | - 按需加载 / 代码分割 | ||
| + | |||
| + | ## 内置模块的兼容 | ||
| + | ### Node 内置模块底层是 CommonJS | ||
| + | ### `module.exports` 被当成默认导出 | ||
| + | ### TS 开关 `esModuleInterop` | ||
| + | ### 所以 `import fs from " | ||
| + | |||
| + | ## node: 前缀 | ||
| + | ### 明确指向内置模块 | ||
| + | ### 不会去 node_modules 找同名包 | ||
| + | ### Node 14.18 / 16 起支持 | ||
| + | ### 只能用于内置模块 | ||
| + | |||
| + | ## 查看 node:path | ||
| + | ### 看接口 | ||
| + | - 装 `@types/ | ||
| + | - Ctrl+点击 → `@types/ | ||
| + | ### 看实现 | ||
| + | - GitHub `nodejs/ | ||
| + | - `fs`/ | ||
| + | ### 列模块名 | ||
| + | - `node -p " | ||
| + | ``` | ||