重构操作不会自动吞掉注释，但多数操作（如extract function、重命名）默认不迁移注释，导致其悬空、错位或丢失；因语言服务器对注释语义支持有限，需手动剪切/粘贴、改用结构化注释并禁用自动格式化干扰。
重构操作会吞掉注释吗？
不会自动吞掉，但绝大多数重构动作（如 Extract Function、Extract Constant、重命名）默认不移动或保留原有注释位置，导致注释“悬空”——比如被留在原地、跟错代码行、甚至被删掉。这不是 bug，而是各语言服务器对注释的语义处理能力有限：vscode-go 会尽量保留结构体字段上的 // 行尾注释；TypeScript 语言服务器在提取函数时通常丢弃选区内注释；Java Extension 对 Javadoc 块注释有较好保留，但对行内 // 注释基本不感知。
哪些重构操作最危险？
以下操作极易破坏注释关联性，需特别留意：
-
Extract Function：选中含//的多行时，VSCode 可能把注释留在原位置，新函数里不带注释，也不提示 -
Extract Constant：字符串字面量旁的// API endpoint注释不会跟着常量声明走，而是卡在旧赋值行 -
Rename Symbol（F2）：若光标落在注释里（哪怕只差一个空格），会直接失败并报 “No result”，不是没反应，是根本没触发 -
Convert to Arrow Function：JS/TS 中转换后，原函数上方的/** @param */JSDoc 有时被剥离，只剩空函数体
怎么保住关键注释不丢？
没有一键保全方案，得靠组合策略：
- 重构前手动剪切注释：比如要提取的表达式旁有
// cache TTL in seconds，先Ctrl+X剪切，等新常量/函数生成后再粘贴到合适位置 - 用结构化注释替代行尾注释：把
const timeout = 5000; // ms改成/** @const {number} - cache TTL in milliseconds */ const timeout = 5000;，JSDoc / Go Doc / JavaDoc 更可能被语言服务器识别并迁移 - 禁用自动格式化干扰：确认
"editor.formatOnSave": false或至少关掉prettier对当前文件类型的作用，否则保存时可能把刚对齐好的注释又打乱 - 重构后立刻检查：尤其注意新生成函数顶部、常量声明上方、字段定义旁——这些是注释最容易“失联”的位置
不同语言的实际表现差异
别指望统一行为，语言后端能力差距很大：
-
Go（vscode-go）：结构体字段标签管理（Go: Add Tags）和Extract Variable对紧邻的//注释保留率最高；但Extract Function仍可能丢掉函数体内的行注释 -
TypeScript：依赖完整类型标注，无/** @param */时，Extract Function生成的参数名可能为arg0，原注释无法绑定 -
Java：Javadoc 块注释（/** ... */）在重命名类/方法时基本保留；但/* inline */块注释和//行注释大概率留在原处 -
C/C++：clang-format 不参与重构逻辑，但启用AlignTrailingComments后，重构完手动运行格式化可快速恢复对齐，前提是注释还在行尾
注释从来不是代码的附属品，而是语义的一部分；重构时把它当变量一样对待——移动、重命名、作用域检查，一个都不能少。
