你一定遇到过这样的情境：编写代码时总感觉哪里不对劲，却又难以准确定位；等到项目实际运行，问题才暴露出来——性能瓶颈、安全漏洞、维护性差……更糟糕的是，代码提交后经人工审查才发现问题，返工成本已经相当可观。

CodeBuddy恰恰能帮你扭转这一局面。它能在你编码过程中实时检测这些问题，并提供具体可执行的改进建议，而非事后才给出反馈。

不过，要让CodeBuddy真正发挥效能，需要掌握几个关键步骤。

启用CodeBuddy深度审查模式

先说明一个要点：CodeBuddy默认仅执行基础语法扫描，要触发更丰富的质量维度检测，必须手动开启上下文感知分析。具体操作：打开VS Code设置→Extensions→CodeBuddy→Review Settings，勾选【Enable Architecture-Aware Analysis】。如果忽略这一步，后续所有建议将停留在变量命名、缩进等表层问题上，实际价值有限。

勾选后，点击"Rebuild Project Index"强制重新扫描整个项目依赖图。这一步尤为关键——如果你最近新增了模块或修改了import路径，旧索引会导致跨文件问题漏检，造成分析结果失真。

运行代码质量热力图分析

接下来，右键任意.ja va或.py文件→选择"CodeBuddy: Analyze Complexity"。扫描完成后，侧边栏会弹出热力图——红色区块代表圈复杂度≥15的高风险函数。不要跳过这一步，它是整个流程的核心入口。

鼠标悬停在某个函数名上，可以查看嵌套深度、条件分支数和具体的CC值。举例来说：一个CC=23的订单处理函数，系统会直接标注"建议拆分：支付校验、库存锁定、日志落库三段逻辑"。这种级别的精准定位，通过简单的/cr命令是无法实现的。

用自然语言指令触发针对性建议

方法一：在编辑器中打开主入口文件（如src/main.py），光标置于任意位置，输入/cr后换行，写明你的具体约束条件。例如这样写：

请基于Clean Architecture原则，检查Controller与Repository之间是否存在直接new实例、SQL拼接、未封装的数据库连接泄露。

方法二：针对已识别的高复杂度函数，选中整段代码→Ctrl+Shift+P→输入"CodeBuddy: Split Function by Responsibility"→回车→在弹出框中输入语义描述，例如"按用户认证、权限校验、会话生成分离"。

这里必须特别提醒：输入描述一定要包含动词+名词结构，不能只写"拆分成三个部分"这类抽象指令，否则生成的接口定义会丢失职责边界，效果会大打折扣。

验证修复建议是否生效

第一步：执行建议后，立即运行CodeBuddy内置的SonarQube轻量版扫描（右键→CodeBuddy: Run Quick Quality Check）。

第二步：对比报告中"Performance""Security""Maintainability"三项得分变化。举个例子，如果"Performance"项分数提升，但"Security"项突然出现新警告，说明生成的建议可能引入了硬编码密钥或未校验的外部输入——遇到这种情况必须警惕。

第三步：对涉及事务或异步调用的函数，额外检查生成代码是否保留了@Transactional注解，是否为每个await调用设置了context.WithTimeout包裹。这两个细节看似不起眼，但缺少任何一个都可能埋下隐患。