光标必须选中完整表达式，因为vscode的extract function依赖ast识别，仅选中部分如.map()会报错“selection is not a valid statement or expression”。
提取函数时为什么光标必须选中完整表达式
VSCode 的 Extract Function 功能不是靠“猜逻辑”，而是依赖 TypeScript/JavaScript 语言服务对 AST 的识别。如果只选中 data.map(...) 而漏掉前面的赋值或 return，它会报错 Cannot extract to function: selection is not a valid statement or expression。
实操建议：
- 选中内容必须是语法上独立、可求值的表达式或语句块，比如整个
return users.filter(u => u.active).map(u => u.name)，而不是其中一段.map(u => u.name) - 在函数体内提取时，优先用鼠标拖选 + 按住
Shift微调边界，避免靠 Ctrl+A 全选——那会把注释或空行也裹进去 - 如果使用快捷键（默认
Ctrl+Shift+R→Extract Function），VSCode 会自动高亮当前光标所在最小子表达式，但这个“子表达式”常偏小，建议手动扩大选择范围再触发
重命名变量时如何避免改错作用域或漏改引用
VSCode 的 Rename Symbol（F2）本质是基于语言服务器的符号解析，不是字符串替换。它能跨文件生效，但前提是：该变量被正确声明且未被动态污染（如 eval、with 或未声明的全局赋值）。
常见坑点：
- 重命名
const user = {...}后，user.name改了，但userProfile（拼写接近但无关）不会动——这是正常行为，不是 bug - 若变量在
for (let i = 0; i 中声明，重命名 <code>i时，所有同名循环变量都会被改，包括其他 for 循环里的i，哪怕不在同一作用域——因为 JS 中let块级作用域解析在旧版 TS 语言服务中偶有误判 - React 函数组件内重命名 props 解构字段（如
const { id, name } = props），必须选中整个解构左侧（{ id, name }）再按 F2，否则只重命名单个字段会导致结构不匹配
TS 项目里提取函数后类型丢失怎么办
VSCode 默认提取函数时不会自动推导返回类型，尤其当原表达式含泛型、联合类型或 Promise 链时，生成的函数可能变成 any 或 unknown，后续调用处类型检查就失效了。
解决方法很直接：
- 提取完成后立刻在函数签名后手动补上类型，例如把
function newFunc() { ... }改成function newFunc(): string[] { ... } - 如果原表达式是异步的（如
await fetch(...).then(...)），提取后函数默认无async，需手动加，并把返回类型写成Promise<t></t> - 启用
"javascript.preferences.includePackageJsonAutoImports": "auto"和"typescript.preferences.includePackageJsonAutoImports": "auto"可减少因类型导入缺失导致的推导失败
哪些场景下 VSCode 重构根本不可用
不是所有代码都能被安全重构。以下情况 VSCode 会直接禁用菜单项或弹出提示：
- 当前文件没开启语法检查：确认状态栏右下角显示
TypeScript或JavaScript，而不是Plain Text；没装对应插件或没识别到tsconfig.json/jsconfig.json就会失效 - 代码存在严重语法错误（如少括号、
return后跟换行再跟对象字面量），语言服务无法构建有效 AST，此时Extract Function和Rename Symbol全部灰掉 - 使用了非标准语法（如装饰器未配
@babel/plugin-proposal-decorators，或 React Server Components 的"use client"指令），语言服务可能跳过该区域，导致重命名不跨组件生效
最常被忽略的是：重命名前没保存文件。VSCode 的重构依赖当前编辑器内容与语言服务缓存的一致性，临时未保存的修改会让符号定位偏移，结果就是改了 A 却把 B 给重命名了。
