光标删除了我文件中的所有注释

Source: Dev.to

发生了什么？

• 差异显示 Cursor 删除了关于弃用时间表的注释、法律审查警告、合规说明以及复杂认证流程的逐步解释。
• 只有少数 JSDoc 块被保留下来。

我从一个包含 41 行注释（JSDoc、内联解释、JIRA 参考、合规说明等）的文件开始，并运行了三次以下提示：

clean up this code

结果： 大约 20 % 的注释被保留。模型始终删除 JIRA 参考、日期戳、逐步解释以及它认为“冗余”的任何内容。

尝试不同的提示

我将提示改为：

refactor this code

并再次运行了三次。

结果： 大约 28 % 的注释被保留——仍然大多数被删除。两个提示都把注释当作噪音处理。

使用 preserve‑comments 规则

我添加了一条 .mdc 规则：

description: "preserve comments during code modifications"
alwaysApply: true

始终在重构、清理和优化过程中保留所有现有代码注释。

再次使用相同的 “clean up this code” 提示运行三次，每次都保留了 41 条注释中的全部 41 条。在一次运行中，模型甚至将魔法数字提取为具名常量，并在响应中明确注明 “per your preserve‑comments rule”。

为什么这很重要

没有这条规则，Cursor 会把 “clean up” 解释为 “删除任何看起来像杂乱的东西”。对 AI 来说，精心编写的合规说明可能看起来像杂乱。模型会优化它认为你想要的——更短、更干净的代码——往往以牺牲文档为代价。

这种行为可能不易被注意，因为差异只显示被删除的行；注释会悄然消失，导致后续开发者失去关键上下文。

我的处理方式

• 我在所有重构任务中使用 preserve‑comments 规则。
• 我运行 cursor‑lint 来确保我的 .mdc 文件具有有效的 front‑matter 并设置了 alwaysApply 标志。
• 我在 GitHub 上维护一套已测试的规则集合（包括注释保留规则以及约 70 条其他规则）。

如果你想对你的设置（规则、项目结构、模型设置）进行完整审查，我提供 $50 异步审计，并附有书面报告。