VSCode重命名变量应使用F2而非Ctrl+H，因其基于语义分析精准修改作用域内所有关联引用；需jsconfig.json或tsconfig.json支持跨文件重命名，否则退化为文本匹配；遇“Cannot rename symbol”多因未初始化、动态生成、语法非法或编码问题。
VSCode 重命名变量用 F2，不是 Ctrl+H
直接全局搜索替换（Ctrl+H）改变量名极容易出错：可能误改字符串、注释、其他同名变量，甚至破坏 JSON 键或 HTML 属性。VSCode 原生支持语义级重命名，前提是当前文件被语言服务正确识别（如 jsconfig.json 或 tsconfig.json 存在，或文件后缀为 .ts/.js）。把光标停在变量名上，按 F2，输入新名字回车——它只改该作用域内所有**语义关联的引用**，包括 import 名、解构赋值、函数参数等。
重命名跨文件生效的前提是项目有配置文件
纯 JS 项目若没 jsconfig.json，TS 项目若没 tsconfig.json，VSCode 默认只做简单文本匹配，F2 会退化成“当前文件内所有出现位置”，无法跳转到定义、也无法安全跨文件重命名。必须补上基础配置：
{
"compilerOptions": {
"target": "ES2020",
"module": "commonjs",
"allowSyntheticDefaultImports": true,
"resolveJsonModule": true,
"esModuleInterop": true,
"skipLibCheck": true,
"forceConsistentCasingInFileNames": true
},
"include": ["**/*.ts", "**/*.js"],
"exclude": ["node_modules"]
}
保存后重启 VSCode 窗口（或运行命令 Developer: Restart Extension Host），再试 F2 —— 此时它才真正理解模块依赖和导出关系。
遇到 Cannot rename symbol 错误的常见原因
这个提示不是 bug，而是语言服务明确拒绝操作，通常因为：
-
const/let声明但未初始化，或声明后被重新赋值（如let x; x = 1; x = 2;），VSCode 无法推断类型与作用域 - 变量来自
eval()、new Function()或模板字符串拼接，属于运行时动态生成，静态分析不可见 - 变量名是保留字（如
class、static）或含非法字符（如my-var），语法解析失败 - 文件编码不是 UTF-8，或 BOM 头导致语言服务加载异常
真要全局文本替换时，务必加约束条件
当语义重命名不可用（比如处理配置文件、JSON、HTML 模板），必须用 Ctrl+H，但得锁死范围：
- 勾选
Match Case和Whole Word，避免user替换掉username - 用
Ctrl+Shift+H打开「全局替换」，限定文件类型（如*.js, *.ts），别无脑选整个工作区 - 先点
Find in Files（Ctrl+Shift+F）预览结果，确认每一条都是目标变量 - 避免在
node_modules或dist目录下执行，这些目录应加入files.exclude或search.exclude
重构不是越快越好，而是改得准。VSCode 的 F2 能省力，但前提是它“看得懂”你的代码结构；看不懂的时候，手动查、加约束、分步验证，比一次全量替换更可靠。
