终极REPL调试工具scope-capture如何把代码运行时上下文时光倒流带回你的REPL【免费下载链接】scope-captureProject your Clojure(Script) REPL into the same context as your code when it ran项目地址: https://gitcode.com/gh_mirrors/sc/scope-capturescope-capture是一款面向 Clojure 与 ClojureScript 开发者的轻量级 REPL 调试库它的核心能力是在代码运行的瞬间给局部变量拍一张快照然后随时把这份运行时上下文时光倒流式地搬回你的 REPL 中自由验证。你再也不需要手动伪造请求、数据库连接或层层嵌套的局部值——让程序自己跑一遍调试现场就完整还原了。️它解决什么痛点为什么需要上下文快照Clojure 社区推崇的 REPL 调试法无堆栈跟踪调试依赖两步重建代码运行时的局部环境用def把局部变量搬出来在 REPL 里求值代码缓冲区的表达式逐步缩小问题范围听起来简单但第一步常常让人崩溃变量越多越嵌套手动复刻这些值既繁琐又容易出错——尤其是 Web 服务里那些难以凭空构造的 HTTP 请求、数据库连接。scope-capture 的价值主张就是要复现某段代码的运行时上下文你只需要让它真正执行一次不一定从 REPL 启动其余的一切由它代劳。这带来三个直接好处调试更轻松跳过重建环境的时间直奔 Bug 本身新人上手更快刚接手项目甚至是刚学 Clojure的人也能机械地、零背景知识地恢复任意代码片段的环境探索成本更低跑个一次性的变体查询、理解项目数据流都变得随手可得快速上手3步把运行时上下文搬进REPL第1步安装到本地开发环境最快配置方法建议不要把 scope-capture 写进项目依赖而是放进你的本地开发环境这样它永远不会进入生产构建Leiningen在~/.lein/profiles.clj的:user配置中加入依赖[vvvvalvalval/scope-capture 0.3.3]并添加:injections [(require sc.api)]Boot在~/.boot/profile.boot中conj同样的依赖并(require sc.api)版本号可在 project.clj 中确认发布记录见 CHANGELOG.md。第2步用 spy 给代码装探针在你怀疑有 Bug 的表达式外面包一层sc.api/spy宏即可(sc.api/spy (- v b))编译时会看到类似日志At Code Site -3, will save scope with locals [a b x y z u v]。然后正常运行程序——每当这行代码执行它所在位置的全部局部变量就会被自动存档日志会给出一个执行点编号如SPY [7 -3] ...。 小技巧spy也可以不包裹任何表达式单独写(sc.api/spy)就能只记录环境侵入性更低详见 doc/Tips-and-Tricks.md。第3步用 defsc / letsc 一键复原现场在 REPL 里输入快照对应的编号整个运行时环境就活了过来(sc.api/letsc 7 [a b u v x y z]) [23 26 4 13 3 4 5]或者用defsc把局部变量def成全局变量——方便配合编辑器求值缓冲区表达式的功能逐个验证(sc.api/defsc 7) a ;; 23 ( x z u) ;; 12作者本人更偏爱defsc的方式。项目教程里有一个完整的实战案例调试一个 Haversine 距离计算函数结果永远是 0.0 米——用defsc恢复现场后逐个求值子表达式很快就发现lat2和lng2竟然都是从p1而不是p2解构出来的。完整过程见 doc/Tutorial.md 与示例脚本 lab/sc/lab/tutorial.clj。像断点一样暂停代码brk 与 loose 系列sc.api/brk是spy的断点版它不立即求值而是把当前线程挂起直到你在 REPL 里放行——此时你可以先恢复环境、检查变量再决定程序怎么走(sc.api/brk msg) ;; 程序停在这里等待你的指令放行时有三种玩法定义见 src/sc/api.cljc方法效果sc.api/loose正常继续执行sc.api/loose-with用你提供的值替换原表达式继续执行sc.api/loose-with-err抛出指定异常跳过后续副作用配合sc.api/disable!还能一键停用某个代码点的记录行为——比如只在循环里断点一次就够了。新手常见坑与清理技巧清单ClojureScript 注意由于编译与运行不在同一地址空间letsc/defsc必须写成(sc.api/letsc [7 -3] ...)的形式同时给出执行点号和代码点号这是最常被踩的坑用完即删spy调用不应留在生产代码里会造成内存泄漏调试完记得(sc.api/dispose! 7)释放已记录的执行点动态 Var 需显式声明(sc.api/spy {:sc/dynamic-vars [*out*]} expr)大输出嫌吵换成安静的spyqt/brkqt只打印值的类型想开一个环境常驻的子 REPL用 src/sc/repl.clj 里的sc.repl/ep-repl之后所有输入都自动包在该快照环境里求值相关文档与源码导航内容路径完整 API 定义spy / brk / defsc / letsc 等全部宏与函数src/sc/api.cljc详细教程含断点、子 REPL、自定义日志、远程 spydoc/Tutorial.md实用技巧清单无参 spy、只捕获错误、合并多个快照、reader 宏doc/Tips-and-Tricks.md可运行的练习示例JVM 与 ClojureScriptlab/sc/lab/tutorial.clj、lab/sc/lab/example.cljcREPL 子环境实现src/sc/repl.clj核心宏的定位速查spy 宏、brk 宏、letsc 宏、defsc 宏。常见问题 FAQscope-capture 是什么一个帮你保存 还原代码局部环境的 REPL 宏库把运行时上下文带回 REPL 求值是 Clojure 的 Pry 式体验。它会影响性能或生产环境吗设计上只用于开发环境装在你的:userprofile 里不进项目依赖用dispose!、undefsc清理即可卸载无负担。和 CIDER/Calva 调试器什么关系scope-capture 专注一件事让你在 REPL 中穿上你程序的双鞋。它不处理数据可视化、执行追踪等其它调试问题可以和 tracing 库、pretty-printer 等工具搭配使用互补而非竞争。一句话总结让代码替你重建现场让你专注于找 Bug——这就是 scope-capture 给 Clojure REPL 工作流带来的时光倒流魔法。✨【免费下载链接】scope-captureProject your Clojure(Script) REPL into the same context as your code when it ran项目地址: https://gitcode.com/gh_mirrors/sc/scope-capture创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考