vscode提取函数需手动选中完整合法语句块、语言模式为js/ts且jsconfig.json已配置、typescript语言服务就绪；快捷键ctrl+shift+r（win/linux）或cmd+shift+r（macos）触发extract method，自动提取外部读取变量为参数，但不处理副作用、this丢失或类型注解。
Shift+F6 重命名必须在定义处触发，F2 在 JS/TS 项目里容易失效
VSCode 的重命名不是文本替换，而是调用语言服务器的 textDocument/rename 接口。光标停在 fetchData() 调用处按 F2，大概率只改当前行——尤其当项目没识别为 TypeScript/JavaScript 项目时。Shift+F6 强制走 LSP 流程，更可靠。
必须满足三个前提：
- 光标落在符号定义上，比如
function fetchData()中的fetchData，而不是某处fetchData()调用 - 文件已保存（未保存的变更不会被 LSP 索引）
- 右下角状态栏显示
TypeScript Server ready或Pylance loaded，否则 rename 请求直接被忽略
Extract Function 要求手动框选完整语句块，不能只放光标
VSCode 不分析控制流或副作用，只校验语法合法性与变量可见性。选中范围不对，直接报 Cannot extract to function。
正确做法：
- 用鼠标拖选，或
Shift + ↓逐行扩展，确保包含完整逻辑：声明、计算、return（不含多余分号） - 想生成带参数的函数？选中部分必须显式包含所有待传入变量的声明，例如：
const a = 1; const b = 2; return a + b;—— 少一个const，参数就漏了 - 含
this、await或闭包变量？自动生成的函数大概率不 work，得手动补async、加参数、处理bind或箭头函数上下文
Ctrl+. 不是万能重构入口，它只响应当前行诊断
Ctrl+. 触发的是 Quick Fix，本质是“修复当前行报错或警告”，不是通用重构菜单。它不会主动建议提取函数或重命名，除非你那一行有 LSP 报出的问题（比如未使用变量、类型不匹配）。
常见误用场景：
- 想提取一段无错误的纯逻辑代码？
Ctrl+.不会出现选项，得用Ctrl+Shift+R或右键 →Refactor > Extract function - Python 顶层表达式无法提取为函数，Pylance 只支持类内方法提取；想封装顶层逻辑，得用
Extract to constant替代 - Java 项目里，
Ctrl+.可能弹出“Extract to local variable”，但不等于“Extract to method”——后者需明确选中并右键操作
跨文件重构失败，先检查 tsconfig.json 或 jsconfig.json
VSCode 的语义重构依赖模块解析能力。没有 tsconfig.json（TS）或 jsconfig.json（JS），LSP 就不知道 import 路径怎么 resolve，跨文件重命名和引用更新会静默失败。
关键配置项：
-
"compilerOptions": { "moduleResolution": "node" }—— 否则import路径根本不会更新 -
"include": ["src/**/*"]—— 确保所有源码目录被纳入索引，否则其他文件里的引用不被识别 - Python 项目要装
Pylance扩展，且工作区根目录下有pyproject.toml或setup.py，否则跨文件跳转和 rename 也受限
重构不是魔法，它是 AST 上的精确手术——缺了配置，连“切哪一刀”都判断不了。
