差别

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

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版
前一修订版
webstorm [2026/10/13 23:12] – 新增「同时跑多个 npm run dev」章节 张叶安webstorm [2026/10/14 09:58] (当前版本) – 5.3 末尾重复条目改为 Node 异步调用栈 张叶安
行 152: 行 152:
 ===== 五、调试技巧 ===== ===== 五、调试技巧 =====
  
-  * **条件断点**:右键已打的断点 → ''Condition'' 填 ''i === 5'',只在条件成立时停 +===== 5.1 断点打在哪儿 ===== 
-  * **Logpoint(日志断点)**:右键断点 → 取消 ''Suspend'',勾上 ''Evaluate and log'',写 ''处理到 ${id}'' —— 只打印不暂停,适合循环里看值 + 
-  * **Variables** 面板:看当前作用域的局部变量与闭包 +  * 断点打在 ''.ts'' / ''.tsx'' 源码行上,靠 source map 映射到编译产物 
-  * **Watches**:把关键表达式固定进来,单步时实时刷新 +  * 断点**空心或灰色**:该行没有可执行代码(注释、空行、''interface''、纯类型声明) 
-  * **Evaluate Expression**(''Alt+F8''):调试中执行任意表达式,也能临时改状态 +  * 断点带**感叹号**:源码与运行中的代码版本对不上,通常是产物过期或 sourcemap 没生效 
-  * **Console** 面板:同样可以跑代码、看输出 + 
-  * **行内值提示**:单步后行尾会直接显示变量当前值 +===== 5.2 比行断点更好用的几种断点 ===== 
-  * ''Mute Breakpoints'':一键静音所有断点,位置保留+ 
 +''Ctrl+Shift+F8''(macOS ''Cmd+Shift+F8'')打开 ''View Breakpoints'',点 ''+'' 添加: 
 + 
 +^ 类型 ^ 适用场景 ^ 关键设置 ^ 
 +| 条件断点 Condition | 循环到第 N 次才停、只在某个用户或 ID 上停 | 填 JS 表达式,如 ''i === 5''、''user.id === 42'' | 
 +| Logpoint 日志断点 | 高频循环 / 回调,不想反复按 F9 | 取消 ''Suspend'',勾 ''Evaluate and log'',写 ''处理到 ${id}'' | 
 +| Exception 异常断点 | 排查“这个错是谁抛的” | ''Catch class'' 填 ''TypeError'',再用 ''Condition'' 收窄 | 
 +| Function 函数断点 | 直接停在方法入口,不用翻到那一行 | 填函数名,可设为只命中一次 | 
 + 
 + 
 +  * **临时断点**:按住 ''Alt'' 点行号区域,命中一次后自动消失,比手动删断点清爽 
 +  * **''debugger;'' 语句**:等价于断点,改代码时顺手写一行,适合只验证一处 
 +  * **Mute Breakpoints**:一键静音所有断点,位置保留,排查完再开 
 +  * **条件表达式别夹带副作用**:别在条件里写 ''console.log''、也别改对象,否则会污染正在观察的状态 
 +  * **异步代码慎暂停**:Node 一暂停 ''event loop'' 也停,''fetch'' / ''axios'' 的请求可能直接超时,这类位置优先用 Logpoint 
 +  * **多个调试会话**:Compound 起的一组 dev server,各 session 的断点可以在 ''View Breakpoints'' 里分别启用或静音 
 + 
 +===== 5.3 查看数据的技巧 ===== 
 + 
 +三个主面板分工不同: 
 + 
 +  * **Variables**:当前帧的 ''Local'' / ''Closure'' / ''Global''。双击值可直接改,改完立即影响后面的逻辑 
 +  * **Watches**:把关键表达式钉住,单步时自动刷新,例如 ''users.filter(u => u.done).length'' 
 +  * **Frames 调用栈**:点上层任意一帧,Variables / Watches 会切到那一帧的上下文 —— 定位“坏数据是哪个调用方传进来的”基本靠它 
 + 
 + 
 +看对象时注意两点: 
 + 
 +  * **对象 id**:''{name: 'a'} #231'' 里的 ''#231'' 是引用标识。两个变量显示同一个 id 说明是同一个对象,排查“改了 A 为什么 B 跟着变”一眼可见 
 +  * **Mark Object**:右键变量标记颜色,同一对象在多处出现会同色高亮,适合追踪一个实例在整条链路上的流转 
 + 
 +大数据与异步栈: 
 + 
 +  * 长数组 / ''Map'' / ''Set'' 默认折叠且有渲染上限,''Settings → Debugger → Data Views'' 可调默认展开层级与数组上限,''Load more'' 按需加载 
 +  * 右键 ''Copy Value''(''Ctrl+C'')能把对象按 JSON 形态复制出来,方便贴到别处比对 
 +  * TS 类型编译后会被擦除,Variables 里看到的是运行时值;判断 ''null'' / ''undefined'' / ''NaN'' 直接用 Evaluate 测 
 +  * Node 12+ 默认提供 async stack trace,Frames 面板能看到 ''await'' 之前的调用链;栈“断”在 Promise 里时,检查 ''Settings → Debugger'' 里的 async stack traces 是否开启
  
 调试控制键(Windows / 括号内为 macOS): 调试控制键(Windows / 括号内为 macOS):
行 172: 行 208:
 | Evaluate Expression | Alt+F8 | | Evaluate Expression | Alt+F8 |
  
-===== 五、常见坑 =====+===== 六、常见坑 =====
  
   * **断点是灰色/空心的**:该行没有可执行代码,或文件没被编译进去。检查 ''include''、''rootDir'',确认 ts-node 真的启用了   * **断点是灰色/空心的**:该行没有可执行代码,或文件没被编译进去。检查 ''include''、''rootDir'',确认 ts-node 真的启用了
行 187: 行 223:
   * **找不到配置文件、相对路径错乱**:把运行配置里的 ''Working directory'' 设为项目根目录   * **找不到配置文件、相对路径错乱**:把运行配置里的 ''Working directory'' 设为项目根目录
   * **改了代码没生效**:方式 B 是编译型的,记得重新 build 或开 ''tsc -w''   * **改了代码没生效**:方式 B 是编译型的,记得重新 build 或开 ''tsc -w''
 +  * **''EADDRINUSE: address already in use''**:端口被另一个项目的 dev server 占了。先按 4.1 给每个项目固定不同端口;想知道是谁占的,用 ''lsof -i :5173''(macOS/Linux)或 ''netstat -ano | findstr :5173''(Windows)
  
 ---- ----
行 210: 行 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 与 Watches +- Exception 断点 Catch class 
-- Evaluate Expression +- Function 断点 停在方法入口 
-- Mute Breakpoints+### 打断点的手感 
 +- 临时断点 Alt + 点行号 
 +- debugger; 语句等价断点 
 +- Mute Breakpoints 一键静音 
 +- 条件里别夹带副作用 
 +- 异步代码慎暂停,优先 Logpoint 
 +- 多会话断点可分别静音 
 +### 看数据的主面板 
 +- Variables 可双击改值 
 +- Watches 钉住表达式 
 +- Frames 调用栈切帧看调用方 
 +### 快速看值 
 +- 行内值提示 
 +- 悬停 tooltip 可加 Watch 
 +- Evaluate Expression Alt+F8 
 +- Console 当 REPL 
 +### 看对象的门道 
 +- 对象 id 判断是否同一引用 
 +- Mark Object 同色高亮 
 +- Copy Value 复制成 JSON 
 +- 类型会被擦除,只看运行时值 
 +### 大数据与异步栈 
 +- 调整数组与展开层级上限 
 +- Node async stack trace
 ## 常见坑 ## 常见坑
 - 断点灰色 = 该行无可执行代码 - 断点灰色 = 该行无可执行代码
行 222: 行 294:
 - ESM 报错 = 换 tsx - ESM 报错 = 换 tsx
 - 路径错乱 = 改 Working directory - 路径错乱 = 改 Working directory
 +- EADDRINUSE = 端口被别的项目占用
 ``` ```
  

该主题尚不存在

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

  • webstorm.1791904341.txt.gz
  • 最后更改: 2026/10/13 23:12
  • 由 张叶安