pitfalls.md

踩坑全集（原 AGENTS.md §4，2026-09-25 迁出）

编号 §4.N 原样保留——代码注释/文档里的 "AGENTS §4.N" 即本文件 4.N。 新坑追加到末尾（编号续排），格式：症状 → 根因 → 修法 → 复现 → 推广铁律。 AGENTS.md 只保留铁律摘要；动某域前按下方索引 grep 该域条目，不必通读。

索引

• 4.1 取异常堆栈必须重进 Realm，否则 SEGV（2026-09-09）
• 4.2 mozjs 153 删了旧 wrapper（2026-09-09）
• 4.3 shell 小坑：zsh 的 =cmd 展开（2026-09-09）
• 4.4 config 0.15 的 prefix 分隔符默认跟随 separator（2026-09-10）
• 4.5 集成测试不继承 bin 的 #[global_allocator]（2026-09-10）
• 4.6 tracing-subscriber 的 init() 已内建 log 桥接（2026-09-10）
• 4.7 UseInternalJobQueues 在 153 下 SEGV，改 RustJobQueue glue（2026-09-10）
• 4.8 引擎/运行时析构期 StoreBuffer 悬垂边 SEGV（2026-09-10）
• 4.9 native 内 Rooted<ValueArray> 注册会 SEGV（2026-09-10）
• 4.10 WINTERJS_LOG 被 config 误收导致启动失败（2026-09-10）
• 4.11 模块 hook 的 referrer 定位：走脚本文件名，不走私有值（2026-09-10）
• 4.12 file URL 必须规范化，否则同一模块判重失效（2026-09-10）
• 4.13 TsconfigDiscovery::Auto 只对 resolve_file 生效（2026-09-10）
• 4.14 with_rooted/with_plain 不可嵌套（2026-09-10）
• 4.15 入口 promise 捕获必须在事件循环前挂载（2026-09-10）
• 4.16 criterion bench 须 harness = false（2026-09-10）
• 4.17 await 在参数位置不报 await 错，TLA 重试须放宽触发（2026-09-10）
• 4.18 结算后退出的循环顶排空 race：progressed 轮不退（2026-09-10）
• 4.19 tower-http 默认追踪打错 target，会被默认 filter 静默（2026-09-10）
• 4.20 写文件命令的手工实测必须先 cd 进 probe 目录（2026-09-10）
• 4.21 同一文件的 edit 与 append 禁并行（2026-09-10，工具约束注记·非代码坑）
• 4.22 rt/engine 声明顺序即 drop 逆序，搬代码别搬反（2026-09-10）
• 4.23 Object.create(prototype) 实例无私有方法 brand 槽（2026-09-11）
• 4.24 同进程多次 runtime::run：引擎单例 + 每文件独立线程（2026-09-11）
• 4.25 clap builder 的 by-value 改造 + value_name 只要 &'static str（2026-09-11）
• 4.26 全 flag CLI 的两条铁律（2026-09-11）
• 4.27 增量解码两阶段 + BYOB 三坑（2026-09-11）
• 4.28 空工具调用可能回滚工作区（2026-09-11，工具约束注记·非代码坑）
• 4.29 serde 缺 rename 即静默丢字段（2026-09-11）
• 4.30 mime_guess 把 .ts 当 MPEG 视频流，serve 须自改 MIME（2026-09-12）
• 4.31 Node CJS → ESM 移植三坑（2026-09-12，Phase 9a）
• 4.32 逐字移植的解环/形态坑（2026-09-12，Phase 9b）
• 4.33 fs 补齐三坑（2026-09-12，Phase 9c）
• 4.34 net 事件循环收尾四坑（2026-09-12，Phase 9d-1）
• 4.35 node:http 回环两坑（2026-09-12，Phase 9d-3）
• 4.36 新事件域 checklist（2026-09-12，Phase 9d-4 dgram 二进宫沉淀）
• 4.37 zlib 两坑（2026-09-12，Phase 9d-5）
• 4.38 https/tls 三坑（2026-09-12，Phase 9d-6）
• 4.39 http2 请求事件双发：构造器与包层别双注册（2026-09-12，Phase 9d-7）
• 4.40 Heap::set 后禁移动，违者 nursery GC 必崩（2026-09-12，Phase 9d-7 总根因）
• 4.41 #[serial] 只保互斥不保顺序，读全局态的用例须先复位（2026-09-12）
• 4.42 黑盒标签断言禁子串，&& 合并打印禁弱断言（2026-09-12，Phase 9e）
• 4.43 手写密码学面的版本墙：digest 0.10 双轨 + HMAC 自架（2026-09-12，Phase 9e）
• 4.44 format! 拼 JS 一律绕行：花括号冲突改文件落盘（2026-09-12，Phase 9e）
• 4.45 9e 杂项小坑三则（2026-09-12）
• 4.46 progressed 后直接 park 会饿死 microtask-only 结算（2026-09-12，§4.18 推广）
• 4.47 newListener 在监听入表之前触发（2026-09-12，Phase 9f-2）
• 4.48 native 重名静默覆盖 + static 判重跨会话误报（2026-09-12，Phase 9f-2）
• 4.49 worker 早失败必须也发 rendezvous，否则主侧超时 + 事件丢失（2026-09-12，Phase 9f-3）
• 4.50 任务尾的资源释放：重构拿掉等待点后即变杀手（2026-09-13，Phase 9g-2）
• 4.51 校验必须待在 __callNative 闭包之外（2026-09-13，Phase 9g-2）
• 4.52 会话收尾先收半端任务，否则 teardown 噪声变 fatal（2026-09-13，Phase 9g-2）
• 4.53 quinn 默认 idle 30s：悬空会话 hang 测试，收尾必须显式关（2026-09-13，Phase 9g-2）
• 4.54 试解循环按长度分发，撞长即误判：看 OID 不看坐标（2026-09-13，Phase 9h-1）
• 4.55 k256 验签拒 high-S：验前 normalize_s（2026-09-13，Phase 9h-1）
• 4.56 Node PKCS#8 省公钥 y：y=g^x mod p 补算（2026-09-13，Phase 9h-1）
• 4.57 跨域 instanceof Promise 恒 false + 跨域求值恒异步（2026-09-13，Phase 9i-1）
• 4.58 迁移排空三件套：offer 留 target + forwarded 排空 + 分发回退（2026-09-13，Phase 9i-2）
• 4.59 CJS 互操作垫片吞掉纯 TLA 的 .js 依赖（2026-09-13，Phase 9j）
• 4.60 util.parseEnv 结果键按 ASCII 排序，非插入序（2026-09-13，Phase 9j）
• 4.61 自递归子进程的动作 flag 碰撞：脚本参数禁复用 winterjs 动作名（2026-09-13，Phase 9j）
• 4.62 stash 期间构建会污染 target，pop 后必须重编再探（2026-09-13，通用构建卫生·非本仓代码坑）
• 4.63 子进程复用自家 CLI 时透传参数必须 -- 收尾（2026-09-13，9k）
• 4.64 成对分隔符夹在中间时 strip_suffix 必空（2026-09-13，9k）
• 4.65 宽松 API 重构到严格语义：先真机实测，再改伪语义断言（2026-09-14，M5）
• 4.66 napi-rs 3 的 Promise 转换暗面 + Either 兜底吞真因（2026-09-14，M5）
• 4.67 vite dev 真变更 139：fsevents 回调专属，polling 通（2026-09-14，M5）
• 4.68 TSFN 的 JS 回调漏标 GC 根：fsevents 真变更 139 根因（2026-09-14，M5）
• 4.69 目录首条目 tarball 炸解包：暂存预建（2026-09-14，M5 vitest 牵引）
• 4.70 入口失败 + 开着的句柄 = 事件循环永不收割（2026-09-14，M5 fork 牵引）
• 4.71 Object.assign 不自建自引用 + 真机 assert 形态先行（2026-09-14，M5）
• 4.72 fork 单槽监听 + CJS 具名上线后的黑盒同步（2026-09-14，M5）
• 4.73 线信封循环引用：先序 id + ref marker，两端同序才成立（2026-09-14，M5）
• 4.74 process.stdout.write("", cb) 无回调实现 = 等落定的协议永挂（2026-09-14，M5）
• 4.75 napi 建面 AB 数据指针必须终身稳定（2026-09-15，M5 终线）
• 4.76 napi_wrap 的 ref 出参两路同发：拒发即 addon 对象无根（2026-09-15，M5 终线）
• 4.77 pin-all（槽位不截断）反例：finalize 链整体死亡（2026-09-15，M5 终线）
• 4.78 GC sweep 内禁 addon finalizer：入队 + 安全点排空（2026-09-15，M5 终线）
• 4.79 截断语义下跨回调裸持 napi_value = 悬垂，call_impl 先验 func 形态（2026-09-15，M5 终线）
• 4.80 CJS 包装五连链的裸 JSVal 栈拷贝：GC 搬移即悬垂（2026-09-15，M5 终线②）
• 4.81 require 条件族：resolver 必须按调用方分流（2026-09-15，M5 终线②）
• 4.82 语义升级（require(esm)+detect-module）后旧边界断言全翻转（2026-09-15，M5 终线②）
• 4.83 无编码 fs 读必须返回 Buffer：String(buf) = utf8 内容（2026-09-15，M5 终线②）
• 4.84 napi_get_cb_info 余槽必须填 undefined（node Args() 契约）（2026-09-15，M6）
• 4.85 定时器实参从未展开：fire_due 直调 + 缓存的 helper 从未被读（2026-09-15，10a）
• 4.86 Writable 默认 autoDestroy:true 会杀保活连接（2026-09-15，10b）
• 4.87 增量泵的"等更多数据"必须带空 rest（2026-09-15，10b）
• 4.88 TLS 写半部 drop 不发 close_notify，双边读端永 block（2026-09-15，10b）
• 4.89 end() 与 connect 竞速：_final 时 socket 未就绪则请求永不发出（2026-09-15，10b）
• 4.90 vm 重跑即炸：sync-in 的重定义必须回落赋值（2026-09-15，10c-3）
• 4.91 turso 懒执行 vs Node prepare eager：校验走只备不步进的 cols（2026-09-15，10d）
• 4.92 RustCrypto 泛型顺序与 AEAD 两侧：ccm 的 M/N 反直觉 + 解密 GHASH over 密文（2026-09-15，10e）
• 4.93 后台 sleep/kill 判 hang 必看退出码（2026-09-15，10e，§4.62/§4.67 姊妹篇）
• 4.94 park 唤醒集与存活判定集必须分家：unrefed 到点要醒、不续命、不算 progress（2026-09-15，10f timers）
• 4.95 宿主调用户回调一律 Reflect.apply，禁走实例属性查找（2026-09-15，10f timers）
• 4.96 CJS→ESM 移植的 primordials 残留：未定义符号在错误路径换错误类型（2026-09-15，10f timers）
• 4.97 全局单例的方法族必须 this 基；--run 完成值回显随 CJS 主模块化消失（2026-09-15，10f timers）
• 4.98 自写编码器不能指望 encodeURIComponent 兜底：unreserved 恒放行（2026-09-16，10f url）
• 4.99 assert.throws 函数形期望：instanceof 必须以 Error 子类为门（2026-09-16，10f url）
• 4.100 肉眼同形异码点：探针先核对码点，NFKD/NFKC 跟 UTS46 走（2026-09-16，10f url）
• 4.101 exit/close 事件 node 是双参 (code, signal)；spawn 默认 stdio 是 pipe（2026-09-16，10f url）
• 4.102 process.emitWarning 是 nextTick 异步派发（2026-09-16，10f url）
• 4.103 Proxy 包 Uint8Array 必须透传 newTarget，否则子类化全灭（2026-09-16，10f buffer）
• 4.104 伪 ArrayBuffer 须品牌拒收，不能信 tag（2026-09-16，10f buffer）
• 4.105 全局 structuredClone 的 transfer 须 detach，否则 isAscii 视残留为真（2026-09-16，10f buffer）
• 4.106 池 AB 不可转移：共享要池化、转移要拒收，两件缺一即挂池套件（2026-09-16，10f buffer）
• 4.107 util.inspect depth -1 空容器显体 + 函数不走 primitives（2026-09-16，10f buffer）
• 4.108 process.nextTick 裸 throw 变 unhandled rejection：uncaught 路由须先探监听（2026-09-16，10f diagnostics_channel）
• 4.109 AsyncLocalStorage.enterWith 是文档化主入口，enter 只是别名（2026-09-16，10f diagnostics_channel）
• 4.110 instanceof 右侧自定义 hasInstance 内禁裸调 getPrototypeOf（2026-09-16，10f diagnostics_channel）
• 4.111 运行时从不 emit unhandledRejection：tracePromise 无 catch 即 fatal（2026-09-16，10f diagnostics_channel，偏离另案）
• 4.112 阻塞 native 停转事件循环：定制查询改投递+轮询（2026-09-16，10f dns）
• 4.113 assert.throws(fn, Error) 裸类须先 instanceof，门错即全灭（2026-09-16，10f dns）
• 4.114 双 Received 口径：ARG_TYPE 用 helper 形，ARG_VALUE 用 inspect 形（2026-09-16，10f dns）
• 4.115 移植先读全文件：文件头校验段漏读=返工三轮（2026-09-16，10f 过程教训·非代码坑）
• 4.116 跨域微任务先 AutoRealm 进执行 global 再 RunJSMicroTask（2026-09-17，10f vm）
• 4.117 cjs goal 探测禁包络形：包装会吞语句语义（2026-09-17，10f vm，§4.59 姊妹）
• 4.118 nextTick 双层调度：原生队列收割，microtask 合并队列语义必反（2026-09-17，10f stream）
• 4.119 __fsCall 闭包内抛的校验错误被 __fsErr 重包成 UNKNOWN（2026-09-17，10f fs）
• 4.120 __cb1 末参即 cb 的校验次序与 node 相反：f 系 fd/mode 先于 cb（2026-09-17，10f fs）
• 4.121 fs_err 包装吞 raw errno：io_code 落 UNKNOWN（2026-09-17，10f fs）
• 4.122 对拍并行跑分未设 TEST_THREAD_ID：全进程共享 .tmp.0 互踩（2026-09-17，10f fs）
• 4.123 命名函数表达式遮蔽外层绑定 → custom promisify 无限递归（2026-09-17，10f fs）
• 4.124 Buffer/TypedArray 自带 Symbol.iterator（吐数字）：视图必须排除在"可迭代 data"分支外（2026-09-17，10f fs）
• 4.125 net 可观测表面五连坑（2026-09-17，10f net 五轮）
• 4.126 重负载验证禁令：禁并行压力循环与重复全量子集（2026-09-17，机器约束）
• 4.127 zlib 轮子 framing 与收尾四坑（2026-09-17，10f zlib 首轮）
• 4.128 child 同步族六坑（2026-09-17，10f child 首轮）
• 4.129 crypto 首轮六坑（2026-09-17，10f crypto 首轮）
• 4.130 crypto 二轮八坑（2026-09-17，10f crypto 二轮）
• 4.131 http 对拍首轮八坑（2026-09-18，10f http 首轮）
• 4.132 worker 对拍五轮七坑（2026-09-18，10f worker 二轮起）
• 4.133 crypto 四轮 + http2 流式化六坑（2026-09-18，10f crypto/http2 收尾）
• 4.134 crypto 五轮 raw 门六坑（2026-09-18，10f crypto 五轮）
• 4.135 crypto 六轮 PSS/PBES2 八坑（2026-09-18，10f crypto 六轮）
• 4.136 Zip移植双坑：HideStackFrames漏挂 + 解压背stop缺失（2026-09-18，10f zlib Zip）
• 4.137 入口失败 + 开着句柄 = 永不收割（eval 路径版）：then 吞 rejection + unhandled 只在循环尾（2026-09-19，10f child 牵引）
• 4.138 net listen 面三坑：字符串端口当 UDS + 无重听守卫 + 柄不随出口清（2026-09-19，10f net）
• 4.139 fork 非 silent 的 stdio null 三面：流式初始化别覆盖真机 null 缺省（2026-09-19，10f child）
• 4.140 G2 __closing relisten 残留：手工过/ cargo 挂 ≠ 环境问题（2026-09-19，欠账轮）
• 4.141 with_str_args 参数跨分配悬垂：rooted 必须在第一个分配之前（2026-09-19，欠账轮）
• 4.142 bisect 禁止连续建 worktree：每个 worktree 的 target 都是全量重编（2026-09-19，欠账轮·灾难记录）
• 4.143 全量 cargo test 禁套 alarm/timeout（2026-09-19，欠账轮）
• 4.144 手工复现脚本放 /tmp 会被清（2026-09-19，欠账轮）
• 4.145 跑分包装 exec 失败静默假绿：exec or die + glob 路径（2026-09-19，G9-3 轮）
• 4.146 一次性 native 丢 opts 二进宫 + raw 字典必须构造期设（2026-09-19，G9-3 轮）
• 4.147 Web CS/DS 错误落 readable：pipeTo 的 cancel 语义（2026-09-19，G9-3 轮）
• 4.148 net 尾件五坑：分包解码/end 回调挂点/abort 发射时序/EPIPE 三条件/HE 回落钩（2026-09-19，G6 轮）
• 4.149 G4 fs validators 轮七坑（2026-09-19，欠账 G4 轮）
• 4.150 edit 工具可能静默吞行：oldString 跨行即 diff 复核（2026-09-20，G5 轮·工具约束）
• 4.151 外层模板字符串内禁写内层模板字面量（2026-09-20，G5 轮）
• 4.152 静默窗防抖在持续写下饿死：fs.watch 改前沿触发（2026-09-20，G8 轮）
• 4.153 notify 回调线程的 TLS state 是错表：分类移分发侧（2026-09-20，G8 轮）
• 4.154 process.exit 哨兵被用户 catch 即覆盖：首个码赢（2026-09-20，G8 轮）
• 4.155 首轮特例的无条件 return 会吞真变迁（2026-09-20，G8 轮）
• 4.156 内部别名 normalize 只认裸形：node: 前缀形落空（2026-09-20，G11 联调缺口）
• 4.157 错误包装函数必须幂等：__fsErr 剥前缀致嵌套重包（2026-09-20，G8 轮）
• 4.158 稀疏检出缺 fixtures 即污染对拍基线（2026-09-21，fs 残簇轮）
• 4.159 mustNotMutateObjectDeep 的 Proxy 断 WeakMap 身份键（2026-09-21，fs 残簇轮）
• 4.160 sync 底座流的双重早退：同步终结派发 + 无句柄续命（2026-09-21，fs 残簇轮）
• 4.161 require 的 make_fn 裸值窗口 + 文件名假相关二分法（2026-09-21，dgram 轮）
• 4.162 fork env 丢失即指数 fork 炸弹（2026-09-21，child 轮）
• 4.163 Rust Stdout 块缓冲吞常驻输出（2026-09-21，child 轮）
• 4.164 数字信号 0 无枚举值，落空即 SIGKILL（2026-09-21，child 轮）
• 4.165 UDS listen 异步绑与同步 cp 的竞态（2026-09-21，fs 轮）
• 4.166 宿主 mock 可见性：内部调用须经默认导出（2026-09-21，fs 轮）
• 4.167 fifo 双 open 死锁：数据必经已开 fd 读（2026-09-21，fs 轮）
• 4.168 旧 SAME1 掩盖 + 跑分两手法（2026-09-21，fs 轮·过程教训）
• 4.169 仅 error 监听的流够不着懒 open + 补丁分支置空（2026-09-21，fs 轮）
• 4.170 tower-http 的 not_found_service 恒改写 404 + 非 GET/HEAD 缺省 405（2026-09-21，plan4 T1）
• 4.171 serve 停机 Wake + 响应构造快照边界（2026-09-21，plan4 T1）
• 4.172 H3 半关闭 FIN + h3-axum 请求体整收（2026-09-21，plan4 T3）
• 4.173 T4 WS 五坑：握手归属/GUID 记忆/构建盲区/自动应答/101 表达（2026-09-21，plan4 T4）
• 4.174 全并行全量偶发 mozilla mutex 解锁失败（2026-09-21，观察中·未闭环）
• 4.175 fifo 黑盒全并行负载下挂死：写者缺席读端零 CPU 睡眠（2026-09-21，观察中）
• 4.176 URLPattern 专项四坑（2026-09-21，plan3 §5）
• 4.177 dgram 余簇五件：校验序/端口序/fork 宽容/伪语义翻转/挂死归属（2026-09-21）
• 4.178 node:test Slice A 四坑（2026-09-21，plan3 test API 轮）
• 4.179 全并行 2 挂再现（2026-09-21，§4.174 家族）
• 4.180 node:test 钩子归属 + MockTracker（2026-09-21，plan3 test B1 轮）
• 4.181 mock.timers 四件（2026-09-21，plan3 test B2 轮）
• 4.182 run(none) 五坑（2026-09-21，plan3 test C 轮）
• 4.183 run(process) 五坑（2026-09-21，plan3 test D 轮）
• 4.184 run 语义深化六坑（2026-09-21，plan3 test E 轮）
• 4.185 http TIMEOUT 轮八坑（2026-09-22，plan3 G11）
• 4.186 服务端 destroy 失声 + 半开续命：两处 hang 一次清（2026-09-22，plan3 G11）
• 4.187 http 升级流八坑（2026-09-22，plan3 G11 upgrade 轮）
• 4.188 http 头面 batch5 九坑（2026-09-22，plan3 G11 头面轮）
• 4.189 http TIMEOUT 深水第一铲：host/auth/CONNECT 隧道九坑（2026-09-22，plan3 G11）
• 4.190 http TIMEOUT 深水第二铲：server 选项面三坑（2026-09-22，plan3 G11）
• 4.191 splitting 一件：ERR_INVALID_CHAR 缺 ["key"] 后缀（2026-09-22，G11）
• 4.192 response 双件：write-after-end 毒化终结块 + 状态码门未注册（2026-09-22，G11）
• 4.193 G11 收尾轮：cork 面双 CRLF + uncaught 吞错 + 小面四件（2026-09-23，plan3 G11）
• 4.194 基建轮：socket.push + 服务端解析错 + 写侧流式化（2026-09-23，plan3 基建）
• 4.195 socket 写错透传四坑：异步确认计数 + 递送顺序 + end 取已记错（2026-09-23，剩余轮 outgoing 面）
• 4.196 TLS 无 connecting 面 + 销毁响应禁回池（2026-09-23，剩余轮）
• 4.197 同一失败的二次投递：socket 迟到错 + flaky 定级（2026-09-23，剩余轮）
• 4.198 readable closed 随 close 发射翻位（2026-09-23，剩余轮）
• 4.199 incomingmessage-destroy 双件 + error/close 分排（2026-09-23，剩余轮）
• 4.200 abort 与 destroy 的错误分流 + 孤儿连接守卫（2026-09-24，剩余轮）
• 4.201 req.signal 早夭 + res-close 排序重构（2026-09-24，剩余轮）
• 4.202 对拍提速三件套（2026-09-24，效率专项·①已落地②③待做）
• 4.203 请求级 createConnection 错误被吞：oncreate 只认 socket 不认 err（2026-09-23，G11 TIMEOUT 轮）
• 4.204 http 欠账清扫轮七坑（2026-09-23，plan3 G11 sweep8 红件簇）
• 4.205 统一 runner 给 node 也带 --run：假红全表 + 过滤丢件（2026-09-25，②③工具轮）
• 4.206 服务端流控/计时三面：pause 事件、dump 机制、headers 计时归属（2026-09-25，http 尾巴轮）
• 4.207 TMPDIR 放 U+F8FF 卷即黑盒假红：URL.pathname 是百分号编码（2026-09-25，D1 轮）
• 4.208 require 把用户异常转串重抛：位置恒 prelude 424:53、NodeError 空文案、原对象丢失（2026-09-25）
• 4.209 node 旗前缀放行 = 自 spawn 无限递归，fork 链吃光内核致系统 panic（2026-09-25，D1 回归）
• 4.210 rustls/webpki 拒收 X.509 v1 证书：服务端绕 keys_match，客户端验签兜底（2026-09-25，P1）
• 4.211 修一个结算点会放出一串假绿：beforeExit 缺失 + process.emit 吞错 + 致命错不发 exit（2026-09-26，P2）
• 4.212 "同步底座 + 特判"的流实现一改就碎：fs 流改逐字移植，底座时序补两处（fs 回调微任务、setImmediate 钳 1ms）（2026-09-26，P2）
• 4.213 io_code 漏 ECONNRESET/ENOTCONN：拆链收尾错全落 UNKNOWN（2026-09-26，P2-tls-b）
• 4.214 listen 字符串参误判 UDS path：address().port 全 undefined（2026-09-26，P2-tls-b）
• 4.215 rustls 对 FIN-无-close_notify 严格报错，node/OpenSSL 视为干净 EOF（2026-09-26，P2-tls-b）
• 4.216 watch 过滤复用 test 表：serve 改 html/css 不触发重启（2026-09-27，CLI --watch 轮）
• 4.217 按调用编译 Regex::new 是启动慢放：CJS 发现 8 正则现场编译烧 1.7s（2026-09-27，F2 轮）
• 4.218 concat ESM 具名导出≠默认导出：新类只挂具名即用户面 undefined（2026-09-27，P2-crypto）
• 4.219 原型污染 setter 探针：native 内部写 JS 层 grep 不到即结构性偏离（2026-09-27，P2-crypto）
• 4.220 自家抛错与真机逐字同形时禁"修正"，修上游误喂（2026-09-27，P2-repl）
• 4.221 同流自回显即真机亦无限递归：repl 黑盒入出分离（2026-09-27，P2-repl）
• 4.222 补全分支劫持含引号成员行：成员→路径→等号段→拒答→bare（2026-09-27，P2-repl）
• 4.223 allowBlockingCompletions 是 fs 补全面开关，无之回空（2026-09-27，P2-repl）
• 4.224 TUI 行编辑替换三坑：管道分流/prompt 拼接/Display 单行（2026-09-28，REPL C 档）
• 4.225 读行线程持 raw mode 时他线程直写终端：多行 LF 阶梯 + prompt 竞争（2026-09-27，REPL 渲染修复）
• 4.265 process.exit 裸传当回调即 receiver 错位（2026-10-04，base16）
• 4.266 throwDeprecation 同步抛是伪语义：真机 nextTick 异步走 uncaught（2026-10-04，base16）
• 4.267 注释写的"真机实测"与套件矛盾时以套件为准（2026-10-04，base16）
• 4.268 http2.connect 无视 lookup + 缺 promisify.custom（2026-10-04，base16）
• 4.269 TLS 服务端同字节双派发：单 st 双 __feed（2026-10-04，base16·记档未修）
• 4.270 修好即多活：DIFF 快败翻 TIMEOUT 挂死（2026-10-04，base16）
• 4.275 同仓并发构建的负载抖动：时序测试 TRY1 败 TRY2 过（2026-10-05）
• 4.276 fs 回调 IO 改同步执行：线程池 FIFO 的单线程最近似（2026-10-05）
• 4.277 逐字移植三件小坑：变体类 / 探针互踩（2026-10-05）

条目

分卷对照（2026-10-05，正文按卷存放，本文件只留索引）

• docs/pitfalls-01.md：4.1–4.67（67 条）
• docs/pitfalls-02.md：4.68–4.124（57 条）
• docs/pitfalls-03.md：4.125–4.169（45 条）
• docs/pitfalls-04.md：4.170–4.205（36 条）
• docs/pitfalls-05.md：4.206–4.264（60 条）
• docs/pitfalls-06.md：4.265–4.277（13 条）

新坑：主索引追一行 + 正文追到末卷（当前 docs/pitfalls-06.md）末尾。