差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
| webstorm [2026/10/13 22:56] – 添加 WebStorm 调试 TS 思维导图 张叶安 | webstorm [2026/10/14 09:58] (当前版本) – 5.3 末尾重复条目改为 Node 异步调用栈 张叶安 | ||
|---|---|---|---|
| 行 74: | 行 74: | ||
| - Vite 开发模式自带 sourcemap;生产构建排查要开 '' | - Vite 开发模式自带 sourcemap;生产构建排查要开 '' | ||
| - | ===== 四、调试技巧 | + | ===== 四、同时跑多个 npm run dev ===== |
| - | * **条件断点**:右键已打的断点 → '' | + | 手上好几个项目,每个都要常驻一个 dev server 时,按下面由简到繁选一种。 |
| - | * **Logpoint(日志断点)**:右键断点 | + | |
| - | * **Variables** 面板:看当前作用域的局部变量与闭包 | + | ===== 4.1 先给每个项目固定端口 ===== |
| - | * **Watches**:把关键表达式固定进来,单步时实时刷新 | + | |
| - | * **Evaluate Expression**('' | + | Vite / Next 发现端口被占会自动换一个端口,结果你调试的 URL 和实际端口对不上。所以第一步是把端口钉死: |
| - | * **Console** 面板:同样可以跑代码、看输出 | + | |
| - | * **行内值提示**:单步后行尾会直接显示变量当前值 | + | ^ 项目 ^ 固定端口的方式 ^ |
| - | * '' | + | | Vite | '' |
| + | | Next.js | '' | ||
| + | | Vue CLI | '' | ||
| + | | CRA | 环境变量 '' | ||
| + | |||
| + | ===== 4.2 方案一:多开 Terminal 标签 ===== | ||
| + | |||
| + | 最简单,适合临时跑两三个项目。底部 '' | ||
| + | |||
| + | <code bash> | ||
| + | # 标签 1 | ||
| + | cd ~/ | ||
| + | |||
| + | # 标签 2 | ||
| + | cd ~/ | ||
| + | </ | ||
| + | |||
| + | %%缺点是终端一关就得重新敲,标签开多了也容易看错目录 —— 项目固定的话往下走。%% | ||
| + | |||
| + | ===== 4.3 方案二:每个项目一个 npm 运行配置 ===== | ||
| + | |||
| + | - 打开项目 A 的 '' | ||
| + | - WebStorm 会自动建一个 npm 配置:'' | ||
| + | - 到 B、C 项目里各重复一次 | ||
| + | - 之后在右上角下拉框里切换、点 Run,几个站点互不干扰地各起一个 | ||
| + | |||
| + | 好处是运行配置记住了各自的工作目录,不用再 '' | ||
| + | |||
| + | %%注意别把不同项目的 '' | ||
| + | |||
| + | ===== 4.4 方案三:Compound 一键启动全部 ===== | ||
| + | |||
| + | '' | ||
| + | |||
| + | ===== 4.5 方案四:一个终端一条命令全跑 ===== | ||
| + | |||
| + | 项目路径固定、只想省事就选这个。在任意一个总目录里建 '' | ||
| + | |||
| + | <code bash> | ||
| + | npm i -D concurrently | ||
| + | </ | ||
| + | |||
| + | <code json> | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | } | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | * '' | ||
| + | * '' | ||
| + | * 等价替代:'' | ||
| + | * '' | ||
| + | |||
| + | ===== 4.6 同时调试多个 dev server ===== | ||
| + | |||
| + | 每个站点配一个 '' | ||
| + | |||
| + | * site-a → '' | ||
| + | * site-b → '' | ||
| + | |||
| + | 只要端口不冲突、sourcemap 正常,这些调试会话可以同时挂着,断点各停各的,互不干扰。 | ||
| + | |||
| + | ===== 五、调试技巧 ===== | ||
| + | |||
| + | ===== 5.1 断点打在哪儿 ===== | ||
| + | |||
| + | * 断点打在 '' | ||
| + | | ||
| + | * 断点带**感叹号**:源码与运行中的代码版本对不上,通常是产物过期或 sourcemap 没生效 | ||
| + | |||
| + | ===== 5.2 比行断点更好用的几种断点 ===== | ||
| + | |||
| + | '' | ||
| + | |||
| + | ^ 类型 ^ 适用场景 ^ 关键设置 ^ | ||
| + | | 条件断点 | ||
| + | | Logpoint 日志断点 | 高频循环 / 回调,不想反复按 F9 | 取消 '' | ||
| + | | Exception 异常断点 | 排查“这个错是谁抛的” | '' | ||
| + | | Function 函数断点 | 直接停在方法入口,不用翻到那一行 | 填函数名,可设为只命中一次 | | ||
| + | |||
| + | |||
| + | * **临时断点**:按住 '' | ||
| + | * **'' | ||
| + | * **Mute Breakpoints**:一键静音所有断点,位置保留,排查完再开 | ||
| + | * **条件表达式别夹带副作用**:别在条件里写 '' | ||
| + | * **异步代码慎暂停**:Node 一暂停 '' | ||
| + | * **多个调试会话**:Compound 起的一组 dev server,各 session 的断点可以在 '' | ||
| + | |||
| + | ===== 5.3 查看数据的技巧 ===== | ||
| + | |||
| + | 三个主面板分工不同: | ||
| + | |||
| + | * **Variables**:当前帧的 '' | ||
| + | * **Watches**:把关键表达式钉住,单步时自动刷新,例如 '' | ||
| + | * **Frames 调用栈**:点上层任意一帧,Variables / Watches 会切到那一帧的上下文 —— 定位“坏数据是哪个调用方传进来的”基本靠它 | ||
| + | |||
| + | |||
| + | 看对象时注意两点: | ||
| + | |||
| + | * **对象 id**:'' | ||
| + | * **Mark Object**:右键变量标记颜色,同一对象在多处出现会同色高亮,适合追踪一个实例在整条链路上的流转 | ||
| + | |||
| + | 大数据与异步栈: | ||
| + | |||
| + | * 长数组 / '' | ||
| + | * 右键 '' | ||
| + | * TS 类型编译后会被擦除,Variables 里看到的是运行时值;判断 '' | ||
| + | * Node 12+ 默认提供 async stack trace,Frames 面板能看到 | ||
| 调试控制键(Windows / 括号内为 macOS): | 调试控制键(Windows / 括号内为 macOS): | ||
| 行 96: | 行 208: | ||
| | Evaluate Expression | Alt+F8 | | | Evaluate Expression | Alt+F8 | | ||
| - | ===== 五、常见坑 ===== | + | ===== 六、常见坑 ===== |
| * **断点是灰色/ | * **断点是灰色/ | ||
| 行 111: | 行 223: | ||
| * **找不到配置文件、相对路径错乱**:把运行配置里的 '' | * **找不到配置文件、相对路径错乱**:把运行配置里的 '' | ||
| * **改了代码没生效**:方式 B 是编译型的,记得重新 build 或开 '' | * **改了代码没生效**:方式 B 是编译型的,记得重新 build 或开 '' | ||
| + | * **'' | ||
| ---- | ---- | ||
| 行 134: | 行 247: | ||
| ### URL 填 dev server 地址 | ### URL 填 dev server 地址 | ||
| ### Vite 开发模式自带 sourcemap | ### Vite 开发模式自带 sourcemap | ||
| + | ## 同时跑多个 dev server | ||
| + | ### 先给各项目固定端口 | ||
| + | ### 方案一 多开 Terminal 标签 | ||
| + | ### 方案二 每项目一个 npm 运行配置 | ||
| + | ### 方案三 Compound 一键启动全部 | ||
| + | ### 方案四 concurrently 一条命令全跑 | ||
| + | ### 每站一个 JavaScript Debug 配置 | ||
| ## 调试技巧 | ## 调试技巧 | ||
| + | ### 断点打在哪儿 | ||
| + | - 断点打在 .ts 源码,靠 source map | ||
| + | - 灰色或空心 = 该行无可执行代码 | ||
| + | - 感叹号 = 产物过期或 sourcemap 失效 | ||
| + | ### 断点类型 View Breakpoints | ||
| - 条件断点 Condition | - 条件断点 Condition | ||
| - Logpoint 只打印不暂停 | - Logpoint 只打印不暂停 | ||
| - | - Variables | + | - Exception 断点 Catch class |
| - | - Evaluate Expression | + | - Function 断点 停在方法入口 |
| - | - Mute Breakpoints | + | ### 打断点的手感 |
| + | - 临时断点 Alt + 点行号 | ||
| + | - debugger; 语句等价断点 | ||
| + | - Mute Breakpoints 一键静音 | ||
| + | - 条件里别夹带副作用 | ||
| + | - 异步代码慎暂停,优先 Logpoint | ||
| + | - 多会话断点可分别静音 | ||
| + | ### 看数据的主面板 | ||
| + | - Variables | ||
| + | - Watches | ||
| + | - Frames 调用栈切帧看调用方 | ||
| + | ### 快速看值 | ||
| + | - 行内值提示 | ||
| + | - 悬停 tooltip 可加 Watch | ||
| + | - Evaluate Expression | ||
| + | - Console 当 REPL | ||
| + | ### 看对象的门道 | ||
| + | - 对象 id 判断是否同一引用 | ||
| + | - Mark Object 同色高亮 | ||
| + | - Copy Value 复制成 JSON | ||
| + | - 类型会被擦除,只看运行时值 | ||
| + | ### 大数据与异步栈 | ||
| + | - 调整数组与展开层级上限 | ||
| + | - Node async stack trace | ||
| ## 常见坑 | ## 常见坑 | ||
| - 断点灰色 = 该行无可执行代码 | - 断点灰色 = 该行无可执行代码 | ||
| 行 146: | 行 294: | ||
| - ESM 报错 = 换 tsx | - ESM 报错 = 换 tsx | ||
| - 路径错乱 = 改 Working directory | - 路径错乱 = 改 Working directory | ||
| + | - EADDRINUSE = 端口被别的项目占用 | ||
| ``` | ``` | ||