VSCode重命名依赖语言服务语义分析，非简单文本替换；失效主因是语言服务未启动或配置缺失，如无jsconfig.json/tsconfig.json、状态栏显示Plain Text、光标位置不当等，导致退化为危险的字符串匹配。
VSCode 的重命名不是“不能”，而是设计逻辑不同：它不做跨作用域的隐式推断，也不默认处理动态引用——这恰恰是它比 WebStorm 更可控、更少出错的原因。
为什么光标停在变量上按 F2，有些地方没变？
这不是功能缺失，而是语言服务明确拒绝修改那些它无法静态确认关联的位置。常见情况包括：
-
obj[variableName]、eval()、new Function()中的变量名——LSP 无法保证运行时行为，直接跳过 - 同名但不同作用域的变量，比如函数参数
id和外层const id = 1——F2 只改当前绑定（lexical binding），不会越界 - 字符串里的硬编码，如日志中的
'user_id'或 JSON 键{"user_id": 1}——语义重命名不碰字符串内容 - 未被语言服务索引的文件：没出现在
tsconfig.json的include列表里，或文件后缀与语言模式不匹配（比如 .js 文件右下角显示的是 Plain Text）
F2 重命名到底依赖哪些配置？
没有这些，F2 就退化为“当前文件内文本替换”，跨文件、import 更新、别名路径识别全失效：
- TypeScript/JavaScript 项目必须有
tsconfig.json或jsconfig.json，且至少含"include": ["**/*"]和有效"compilerOptions" - Python 项目需启用
Pylance（不是基础 Python 扩展），并确保根目录有pyproject.toml或pyrightconfig.json - Vue/Svelte/Astro 等框架需对应 LSP 插件（如
Volar、Svelte for VS Code），否则<script setup>内的符号不参与重命名 - 路径别名（如
@/utils）要写进tsconfig.json的"paths"，否则 import 引用无法被正确解析和更新
遇到 “Cannot rename symbol” 怎么办？
这个报错是语言服务的主动拦截，不是 bug。先看状态栏是否显示 1 definition, 3 references；不显示，说明符号还没被接管：
- 检查右下角语言模式——点击切换成正确的语言（如 TypeScript React，而非 JavaScript）
- 运行命令
Developer: Restart Extension Host或TypeScript: Restart TS Server - 确认变量不是声明即用但未初始化：
let x;后直接x = 1，某些 LSP 版本会丢失定义上下文 - 避免在
node_modules或未开启的.d.ts文件中尝试重命名——LSP 默认禁止修改第三方代码
手动全局替换时最容易踩的坑
当语义重命名不可用（比如改配置项、JSON Schema、HTML 模板），必须用 Ctrl+Shift+H 全局替换，但以下操作缺一不可：
- 务必勾选
Match Case和Whole Word，否则user会误改username、debugUser - 限定文件类型：
files to include填*.json, *.ts, *.js，别选整个工作区 - 禁用
Use Regular Expression——除非你真需要正则捕获组修 import 路径（例如把from './utils'替成from '@/utils'） - 执行前点开预览窗口，逐个确认高亮位置：是否在字符串里？是否是 HTML 属性？是否属于第三方库调用？
最常被忽略的一点：重命名不是“改完就完事”。即使 F2 成功执行，也得人工检查三处——日志字符串、动态键访问（obj[key]）、以及所有未被 LSP 索引的配置文件。VSCode 的克制，恰恰是它在大型项目里不制造静默错误的底气。
