代码重复是个老问题。你接手一个项目，打开某个文件，发现大段大段的代码块似曾相识——要么是复制粘贴留下的痕迹，要么是团队协作时没清理的冗余。手动找？不现实。grep？只能搜关键词，没法定位结构相似的片段。这时候你需要一个专业的检测工具，jscpd 就是一个不错的选择。
为什么选择 jscpd？
jscpd 的全称是“JavaScript Copy/Paste Detector”，但它早已不局限于 JS。目前支持 223 种格式，从主流语言（Python、Java、C++）到配置文件、Markdown 都能处理。它的检测引擎基于抽象语法树（AST）与文本相似度结合，既能识别精确复制，也能发现 经过变量重命名或换行调整的克隆。这在实际项目中很常见：开发者复制一段逻辑，改了变量名和注释，但结构本质相同。
对于大型代码库，jscpd 的性能也经过优化。它支持 增量检测，只扫描变更的文件，并且可以设置最小 token 数来过滤掉短小的重复片段（比如 getter/setter 样板代码）。输出格式多样：JSON、HTML、XML 等，方便集成到 CI/CD 流水线中。
AI 时代的独特设计
jscpd 的维护者特意为 AI 工作流做了适配。它提供了 token-efficient reporter，能够以极少的 token 量输出检测结果，方便传给大语言模型做进一步分析或修复建议。此外还内置了 Skill 和 MCP 服务器（Model Context Protocol），允许 AI Agent 直接调用 jscpd 的能力。这意味着你可以写一段自然语言指令：“检测当前项目中的重复代码，并生成重构方案”，然后由智能体完成整个流程。
听起来挺玄，但实际跑一遍就懂。它的 CLI 使用简单：
jscpd ./src– 扫描 src 目录下的所有文件jscpd --formats typescript,markdown– 只检测特定格式jscpd --min-lines 5 --min-tokens 50– 设置阈值，避免误报
结果会列出重复片段的位置、行数和相似度百分比，并用颜色标记。直观且精准。
实际使用场景：代码审查与重构
想象一下你在做一次大型重构：需要把某个功能模块抽取成独立库。先跑一遍 jscpd，迅速定位哪些地方有重复实现。然后你就能集中精力合并这些代码，而不是在数千个文件中凭感觉猜测。对于新加入团队的开发者，jscpd 也能作为代码质量检查的一环——在 CI 中一旦发现克隆比例超过阈值，就阻断合并或发出警告。
一个值得注意的细节是 jscpd 不依赖外部服务，所有检测都在本地完成，保证了代码安全。这点对金融、医疗等合规要求严格的行业尤其有意义。
局限与说明
没有任何工具是完美的。jscpd 更擅长检测结构相似的“语法克隆”，对于语义相同但实现差异巨大的片段（比如一个用递归、一个用迭代），它可能无法识别。此外，检测结果需要人工甄别：有些“重复”可能是业务需要的统一逻辑（如校验规则），不应盲目删除。最后，对于超大型单体仓库（百万行级别），初始扫描仍需要一些时间，虽然比同类工具已经快不少。
jscpd 是一个实用、专注且持续更新的开源项目。如果你正在为代码重复感到头疼，不妨给它几分钟时间——也许能省下之后几小时的排查功夫。
评论
暂无评论
成为第一个评论的人