如何在不破坏旧代码逻辑的边界上重新构建代码：Cursor 的实践与技巧

在处理长期积累的“屎山”代码库时，Cursor 的核心问题在于 AI 容易忽视历史逻辑细节，例如在“优化”过程中将异常处理流程简化为默认值，导致运行时崩溃。解决方案不是简单地让 AI “重构”，而是通过严格的约束框架和逐步验证流程，确保每次修改都不会引入新的 Bug。这不仅需要明确的配置规则，还需要选择能够保留旧代码隐含逻辑的 AI 模型。

规则配置：遏制 AI 的“优化”行为

Cursor 的默认指令往往随机性较高，容易让 AI 以“最简化”的方式重构代码。为了避免这种风险，建议在项目根目录创建 .cursorrules 文件，明确重构遵循的协议。例如：

1. 优先保留外部行为：在下达重构指令前，必须明确是否允许修改 API 签名或公共接口，除非有明确需求。
2. 边界情况映射：在修改任何逻辑之前，必须通过 AI 列举出原代码处理的所有特殊情况，并确保这些情况在重构后仍然存在。
3. 逐步迭代重构：避免一次性对整个文件进行大规模改动，而是将重构分解为小型逻辑单元，逐步优化代码结构。
4. 不猜测变量意图：如果变量的用途不明确，AI 要优先询问用户明确意图，而不是随意重命名或改变行为。

这些规则能有效限制 AI 的过度优化行为，但需要注意的是，如果 .cursorrules 文件未正确配置，Cursor 可能会忽略这些限制。例如，如果文件内容过于简单或缺少关键字段，AI 仍然可能偏离预期。

模型选择：Claude 3.5 vs GPT-4o

在重构旧代码时，Claude 3.5 Sonnet 表现更稳妥，因为其在处理复杂历史代码时能更准确地识别隐含逻辑。例如，在处理 2015 年的旧 Java 代码（如嵌套 if-else 结构）时，Claude 3.5 能精准保留原有逻辑，同时通过现代化改进代码结构，而不会轻易简化异常处理逻辑。相比之下，GPT-4o 更倾向于将代码转换为通用模版，可能忽略业务特定的边界条件，导致后续运行时出现未预期的 Bug。

不过，如果 User-Agent 设置不当，Cursor 可能会被网络策略阻止访问。例如，在某些服务器端点（如某些 API 或代码托管平台）中，如果 User-Agent 字段为空或过于通用（如 curl 或 Python-requests），可能会触发防范机制。此时，可以尝试设置一个描述性且唯一的 User-Agent（如 Mozilla/5.0 (iOS; User-Agent: iOS-16.0; a0f5b8-82fa-7118-aba4-c714b78408e2)），或者恢复默认设置，以避免被误拦截。

三步法减少重构风险

直接下达“重构此文件”指令的风险极高，因为 AI 可能忽略关键逻辑。推荐采用“分析 → 确认 → 执行”的三步法：

1. 分析阶段：

使用精准的 Prompt 要求 AI 详细列出代码中所有业务规则和边界情况，不允许任何代码修改。例如：

   Analyze @filename. Enumerate every business rule and edge case it handles, including error conditions and compatibility notes. Do not modify any code.

如果 AI 的分析结果不完整，则需要人工审核并补充细节。例如，某些旧代码可能依赖特定版本的库（如 Java 8 的 Stream API），AI 可能会忽略这些兼容性要求。

1. 确认阶段：

审核 AI 生成的逻辑清单，确保无遗漏或误判后，再下达重构指令。例如：

   Now refactor this file to improve readability, but strictly adhere to the following rules:
   - Keep all edge cases from the analysis phase intact.
   - Do not alter public methods or API signatures unless explicitly required.

如果在确认阶段发现逻辑漏洞（如遗漏某个异常情况），则需要重新调整 Prompt 或人工干预。

1. 执行阶段：

仅在逻辑清单完全确认后，AI 方可进行重构。例如，在执行前，Cursor 会生成一个“重构计划”，并询问用户确认。如果用户同意，Cursor 才会实际修改代码。

优势：

• 通过 .cursorrules 和 Claude 3.5 的结合，能有效降低重构后的 Bug 率，尤其是在缺乏单元测试的“屎山”代码库中。
• 确认制流程确保 AI 不会忽略关键逻辑，但速度较慢，无法实现“一键重构”。此外，在 Token 窗口受限的情况下，Cursor 可能无法完整捕捉远程调用的副作用（如跨文件的依赖关系），导致部分逻辑被遗漏。

实践中的注意事项

除了上述步骤，还需要注意 Cursor 的网络限制。例如，如果在某些代码托管平台（如某些云服务或私有仓库）中，Cursor 的请求可能会因为网络策略被阻止。此时，可以尝试：

1. 更改 User-Agent 字段（如 a0f5b8-82fa-7118-aba4-c714b78408e2），并确保其唯一且描述性强。
2. 恢复到默认 User-Agent（如 Mozilla/5.0），以避免被误拦截。
3. 在遇到被阻止的情况，联系平台支持并提交订单（如 Reddit 帐号相关的 ticket），详细说明问题（如提交代码 01a0f5b8-82fa-7118-aba4-c714b78408e2）。

此外，如果在重构过程中发现 AI 生成的代码与原始逻辑不符，则需要立即终止重构并重新审核 Prompt 或配置。例如，某些旧代码可能依赖特定的编译器优化（如 GCC 的 -fPIC），AI 可能会忽略这些细节，导致链接错误。