VSCode 的 F2 重命名需光标位于完整标识符起始处，否则失败；Ctrl+Shift+R 提取函数须选中语法合法的连续语句；跨文件重命名依赖类型标注，JSDoc 或 TypeScript 可提升准确性。
光标必须落在完整标识符起始位置才能触发 F2
VSCode 的 F2 重命名不是“点哪改哪”，而是依赖语法解析器识别符号边界。光标停在 userName 中间、末尾空格后、或字符串里，都会提示 “No result” 或只改局部（比如只改 obj.name 中的 name，不改对象定义里的 key）。
- 正确做法：用鼠标双击变量名，或按
Ctrl+←跳到词首，确保整个标识符被高亮（如fetchData完整蓝框） - 常见失败场景：在
const user = { name: 'a' }中把光标放在冒号后或引号内按F2，不会触发重命名 - 若想同步改对象 key 和所有访问，需先选中
name:这部分再按F2
Ctrl+Shift+R 提取函数前必须选中连续可执行语句
VSCode 不会帮你补逻辑断点。选中代码块如果包含半截 if、跨函数边界、或带 return 但不在顶层，就会报 “Cannot extract to function”。
- 必须是语法合法、能独立成函数的语句序列，例如：
const result = a + b; console.log(result); return result; - 返回值推导只认最后一行
return，前面的console.log或副作用会被原样搬进新函数 —— 很容易导致逻辑错位 - 闭包变量（如外层
let count）不会自动作为参数传入，提取后得手动加参数或检查作用域
跨文件重命名依赖语言服务，.js 文件没 JSDoc 类型就可能漏引用
TypeScript 项目基本无感，但纯 JavaScript 项目里，如果函数调用链缺乏类型标注，F2 可能只更新当前文件，漏掉其他文件中通过动态导入或无类型调用的引用。
- 解决办法：给关键函数加
/** @param {string} id */这类JSDoc注释，或直接用.ts后缀 - 模块导入导出必须规范：
export function fetchData()+import { fetchData } from './api'才能触发跨文件联动 - 动态拼接的调用（如
obj[methodName]()）永远无法被识别，这类设计本身就不适合用F2重构
Extract Constant 默认声明在函数顶部，不是块级作用域
在 for 循环里选中一个 URL 字符串按 Ctrl+Shift+P → Extract Constant，生成的 const API_URL = '...' 会出现在函数最上面，而不是循环块内 —— 这既不符合直觉，也破坏了作用域意图。
- 更可控的做法：手动写
const API_URL = '...';在合适位置，再用F2重命名它 - 模板字符串（如
`/user/${id}`）无法提取，必须先简化为静态字符串 - 数字、布尔字面量提取后无类型，后续使用时 IDE 无法提供精准提示
复杂点在于：重命名和提取不是孤立操作。真正安全的重构，往往要先补 JSDoc 或转 TS，再用 F2；提取函数后还得立刻检查参数、返回值和闭包变量——这些细节不盯住，自动化反而埋雷。
