安全重命名必须基于语言服务的语义分析，而非字符串匹配；ctrl+h会误改foobor、注释等，而f2触发的rename symbol才真正识别作用域与定义位置。
为什么直接用 Ctrl+H 替换函数名经常出错
因为普通查找替换不识别语法结构，foo 会把 foobar、my_foo_handler、注释里的 // calls foo() 全部误改。真正安全的函数重命名必须基于语言服务的语义分析，而不是字符串匹配。
必须开启对应语言的官方扩展和语义支持
VSCode 自身不解析代码，重命名能力完全依赖安装的语言扩展（如 Python 的 Pylance、JavaScript/TypeScript 的 TypeScript and JavaScript Language Features 内置支持）。没装对扩展，右键 Refactor > Rename 会灰掉或报错 No rename provider available。
- Python：确保已启用
Pylance（非Python扩展单独启用），并在设置中确认"python.languageServer": "Pylance" - TypeScript/JS：默认启用，但若项目无
tsconfig.json或jsconfig.json，可能降级为基础文本替换 —— 补一个空配置文件即可激活完整语义 - Go、Rust、Java 等同理：必须安装对应 LSP 扩展，且项目能被正确加载（如
go mod init已运行）
正确触发函数重命名的两种方式
语义重命名只能作用于“被语言服务识别为声明位置”的函数名，比如 function myFunc() { } 中的 myFunc，而不是调用处的 myFunc()。
- 光标停在函数定义名上（不是调用处），按
F2—— 最快最稳 - 右键 →
Refactor > Rename Symbol（注意不是Replace in Files） - 如果
F2没反应，先按Ctrl+Shift+P输入Developer: Toggle Developer Tools，看 Console 是否报rename provider相关错误，大概率是扩展未就绪或文件未被纳入项目范围
重命名后要注意的边界情况
即使语义重命名成功，仍可能漏改或误改某些场景，尤其在动态语言或跨文件弱绑定时：
- 字符串拼接调用：
const name = 'my' + 'Func'; window[name]();—— 这类不会被重命名捕获 - CommonJS 动态
require()或import()的模块导出名，若未被静态分析到，可能遗漏 - Python 中通过
getattr(obj, 'old_name')()调用的，也不会更新字符串字面量 - 重命名后记得检查 Git diff，重点扫一眼
import/from ... import行、类型注解、JSDoc@param里的旧名
语义重命名不是魔法，它只改语言服务“看得见”的引用。那些靠运行时拼接、反射、字符串 eval 建立的连接，得人工核对。
