差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 后一修订版 | 前一修订版 | ||
| typescript:导入模块 [2026/10/10 22:31] – 创建 张叶安 | typescript:导入模块 [2026/10/10 23:25] (当前版本) – 思维导图补充默认导出相关要点 张叶安 | ||
|---|---|---|---|
| 行 82: | 行 82: | ||
| </ | </ | ||
| - | **5. 注意事项** | + | **5. 为什么有的导入带花括号?** |
| + | |||
| + | 花括号不是可选的写法,它直接对应**被导入模块是怎么导出的**:默认导出('' | ||
| + | |||
| + | <code typescript> | ||
| + | // module-a.ts —— 两种导出都有 | ||
| + | export default function handler() {} // 默认导出:一个模块只能有一个 | ||
| + | export const PI = 3.14; // 命名导出 | ||
| + | export function add(a: number, b: number) { return a + b; } | ||
| + | |||
| + | // main.ts —— 三种导入方式 | ||
| + | import handler from " | ||
| + | import { PI, add } from " | ||
| + | import handler2, { PI as pi } from " | ||
| + | import * as a from " | ||
| + | </ | ||
| + | |||
| + | 对照表: | ||
| + | |||
| + | ^ 写法 ^ 取的是什么 ^ 对应模块里的写法 ^ | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | |||
| + | **那'' | ||
| + | |||
| + | **" | ||
| + | |||
| + | * **可读性**:'' | ||
| + | * **打包体积**:带花括号的命名导入,Vite / webpack / rollup 能做 tree-shaking,把没用到的导出裁掉;'' | ||
| + | * **名字绑定**:命名导入的名字必须和导出时一致(可用 '' | ||
| + | |||
| + | **记忆口诀:** | ||
| + | |||
| + | * 整个对象一起拿 → **不带花括号**('' | ||
| + | * 按名字挑几样 → **带花括号**('' | ||
| + | * 全都要 → '' | ||
| + | * 不确定 → 先 '' | ||
| + | |||
| + | **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. '' | ||
| + | |||
| + | **为什么要写'' | ||
| + | |||
| + | * 明确表示" | ||
| + | * Node 14.18 / 16 起支持,新代码推荐统一加上。不带前缀的 ''" | ||
| + | * 注意:'' | ||
| + | |||
| + | **看" | ||
| + | |||
| + | <code bash> | ||
| + | npm i -D @types/ | ||
| + | </ | ||
| + | |||
| + | 然后编辑器里 **Ctrl + 点击**(macOS:Cmd + 点击)'' | ||
| + | |||
| + | **看" | ||
| + | |||
| + | Node 把内置模块的 JS 实现编译进了二进制(内置快照),所以本地找不到 '' | ||
| + | |||
| + | <code bash> | ||
| + | # 1) 列出所有内置模块名 | ||
| + | node -p " | ||
| + | |||
| + | # 2) 看 path 模块导出了哪些东西(只有名字,没有实现) | ||
| + | node -p " | ||
| + | |||
| + | # 3) 旧版本 Node 能打印内置模块的源码字符串;新版本已弃用,可能报错 | ||
| + | node -e " | ||
| + | </ | ||
| + | |||
| + | 最可靠的是直接对照官方仓库: | ||
| + | |||
| + | * 仓库:'' | ||
| + | * 直接看单个文件,比如 path:'' | ||
| + | * '' | ||
| + | |||
| + | **回到本节开头那段代码:** | ||
| + | |||
| + | <code typescript> | ||
| + | import fs from ' | ||
| + | import path from ' | ||
| + | import crypto from ' | ||
| + | import zlib from ' | ||
| + | import { fileURLToPath } from ' | ||
| + | </ | ||
| + | |||
| + | 前四个是把模块**整体**拿进来(拿到的是带各种方法的对象),最后一个是从 '' | ||
| + | |||
| + | **8. 注意事项** | ||
| * `import` / `export` 必须写在**模块顶层**,不能放进函数或 `if` 里(`import()` 动态导入除外)。 | * `import` / `export` 必须写在**模块顶层**,不能放进函数或 `if` 里(`import()` 动态导入除外)。 | ||
| 行 91: | 行 232: | ||
| * 默认导出和命名导出可以同时用,但一个模块只能有一个默认导出。 | * 默认导出和命名导出可以同时用,但一个模块只能有一个默认导出。 | ||
| - | **6. 练习题** | + | **9. 练习题** |
| **练习 1** | **练习 1** | ||
| 行 154: | 行 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 " | ||
| + | ``` | ||