一天内搞定 50 万行遗留代码分析并准时下班的配置
TuBrief 편집팀
2026년 8월 12일
0
Computing/Software원본 영상을 바탕으로 AI의 도움을 받아 작성했습니다. 원본 영상이 기준입니다.
커뮤니티의 다른 글
댓글 (0)
Log in to leave a comment
아직 작성된 글이 없습니다
원본 영상을 바탕으로 AI의 도움을 받아 작성했습니다. 원본 영상이 기준입니다.
Log in to leave a comment
아직 작성된 글이 없습니다
在公司防火墙和代理环境下运行基于终端的开发工具时，会遇到网络拦截报错。其原因是公司根证书验证失败。由于运行时的特性，它绕过了操作系统的默认存储区。
需要直接在终端配置文件中进行设置。在 HTTP_PROXY 和 HTTPS_PROXY 变量中输入公司代理地址。在 NODE_EXTRA_CA_CERTS 变量中指定公司根证书文件路径。将 ANTHROPIC_BASE_URL 设置为本地 Ollama 端点，并将 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 的值设为 1，即可阻止外部通信。在遵守防火墙规定的同时消除扫描报错，并减少配置时间。
如果在超过 50 万行的单体仓库中运行完整扫描，会花费 30 分钟或者因堆内存错误而中断。在 16GB RAM 环境下，必须使用 14B 或 20B 大小的本地模型，扫描器才能支撑。在项目根目录下创建 .understandignore 文件。
应用排除模式的方法很简单。在顶层目录下创建文件，并写入 **/node_modules/, **/target/, **/build/, **/src/test/ 路径。在终端中输入 NODE_OPTIONS="--max-old-space-size=8192" 命令来增加 Node.js 堆内存限制。随着分析目标文件的减少，初始扫描完成时间将缩短至 3 分钟以内。
如果针对整个庞大仓库进行提问，知识图谱中的数万个节点会同时加载，从而导致幻觉现象。新旧版本的支付类会被混淆，进而调出无法运行的方法。必须缩小业务逻辑区域。
将查询范围限定在特定目录的步骤如下。查看单个文件时，在命令后附加目标文件的相对路径。把握领域流向时，仅执行提取特定领域边界内节点的命令。在使用聊天命令时，也要明确指定要审查的目录路径并排除测试文件夹。随着节点数量的减少，代码探索的准确性会随之提高。
如果仅凭 AI 给出的结果盲目修改代码会存在风险。必须直接比对知识图谱输出与实际源代码是否一致。打开 IDE 文件搜索功能，查看 AI 提到的大致方法是否实际存在。验证调用关系，并确认事务范围和映射文件。在修改代码之前，执行分析影响范围的命令。
在负责人离职且缺乏文档的遗留系统中，即便只是想弄懂一个 API，也需要翻阅几十个文件。使用 Understand-Anything 的工具，可以生成从入口点开始按层级依赖顺序引导系统的导游（Tour）。无需每次都去询问资深开发人员。
提取请求与响应流向图的方法如下。知识图谱分析完成后，调出仪表盘 UI。从菜单中选择导游功能或直接输入命令。依次跟随从 API 入口点延伸至后端服务和数据库的节点，将执行流向可视化。
在着手处理遗留代码时，必须提前计算副作用。修改代码后、提交之前，运行将变更文件转换为图表节点的命令。综合计算出关联的节点。提前把握变更事项对现有 API 或批处理作业产生的影响。
将分析好的资产提取为 Markdown 格式并注册到公司 Wiki 中。提交扫描完成后生成的知识图谱文件，以清理文档债务。如果文件过大，则使用 Git LFS 进行管理。设置大文件追踪，将配置文件上传至仓库并用作入门指南。每次提交时设置触发增量流水线，无需每次都运行完整扫描，即可保持最新的架构状态。