VSCode通过语言服务器解析AST和作用域链来区分局部与全局变量：重命名时仅更新同作用域内的绑定，如inner函数中let value=20的声明及引用，不影响外层value=10；依赖完整符号表、严格模式、块级作用域声明（避免var）及项目配置（如tsconfig.json）确保作用域链准确构建。
VSCode 重命名时如何识别局部变量 vs 全局变量
VSCode 不靠字符串匹配，而是依赖语言服务器解析 AST 和作用域链。当你在 inner 函数里对 value 按 F2 重命名，它只改该函数块内声明的 let value = 20 及其引用，外层 value = 10 完全不受影响——因为语言服务器能明确区分这两个 value 绑定在不同作用域节点上。
这要求语言服务已构建完整符号表，常见干扰项包括：
- 未启用严格模式或类型检查（如 TypeScript 中
"strict": false会弱化作用域推断） - 使用
var声明——其函数作用域特性易与块级作用域混淆，导致引用范围误判 - 动态属性访问（如
obj[variableName]）不会被识别为符号引用，重命名时自动排除
为什么有时候右键“重命名符号”是灰色的
功能不可用通常不是编辑器问题，而是语言服务没把当前符号识别为可绑定标识符。典型场景有：
- 光标停在字符串字面量里，比如
"user_id"中的user_id—— 这只是文本，不是符号 - JS/TS 文件缺失
jsconfig.json或tsconfig.json，导致语言服务器无法建立项目上下文和跨文件作用域链接 - Python 文件未安装 Pylance，或
python.defaultInterpreterPath指向错误环境，使符号解析退化为纯文本扫描 - 符号定义本身不完整，例如
const foo;（无初始化）在 TS 中可能无法生成有效绑定
跨文件重命名时，VSCode 怎么知道该不该改 import 名
它看的是导出/导入语义，不是文件路径或字符串相似性。例如：
/* math.js */
export function calculateSum(a, b) { return a + b; }
/* app.js */
import { calculateSum } from './math';
console.log(calculateSum(1, 2));
当你重命名 calculateSum，VSCode 会同时更新：
-
math.js中的function calculateSum -
app.js中的import { calculateSum }解构名 -
app.js中的calculateSum(1, 2)调用
但如果你写的是 import * as math from './math'，再调用 math.calculateSum()，重命名仍生效——因为语言服务器通过 AST 确认了 math.calculateSum 是对导出符号的引用，而非任意属性访问。
容易被忽略的配置硬性依赖
即使装了正确语言服务器，以下配置缺一不可：
- TypeScript/JS 项目必须有
tsconfig.json或jsconfig.json，且"include"明确覆盖所有源码目录，否则跨文件作用域链断裂 - Python 项目需在设置中启用
python.analysis.typeCheckingMode（推荐"basic"），否则 Pylance 默认跳过作用域深度分析 - Go 项目要确保
gopls已完成首次索引（查看 VSCode 输出面板 → “Go” 日志，等出现indexing finished） - 禁用
"editor.renameOnType": false会影响部分语言的实时重命名响应，但不影响F2主流程
作用域识别的精度最终取决于语言服务器是否完成了项目级索引，而不是你按了多少次 F2。没索引完就重命名，很可能只改了当前文件——这点在大型 monorepo 里尤其隐蔽。
