F2重命名不更新import行，因语言服务未识别引用：符号须具名导出且文件在tsconfig/jsconfig作用域内；Python中Pylance默认不反向修改定义或import语句，动态访问、any类型、字符串拼接等静态分析无法覆盖。
F2 重命名后报错，大概率不是操作错了，而是语言服务压根没识别到那些引用位置——它根本没改，你却以为改了。
为什么 F2 重命名后 import 行没变？
VSCode 的 Rename Symbol（F2）只作用于「符号定义 + 当前项目中被语言服务成功解析的引用」。import 行是否更新，取决于两个关键点：
- 目标符号是否被正确导出：必须是
export function foo()这类具名导出；export default或export * from场景下，重命名通常不触达导入语句 - 导入方是否在语言服务作用域内：检查
tsconfig.json或jsconfig.json的"include"是否包含该文件，且未被"exclude"拦截 - 路径别名未生效时，import 路径标红 → 语言服务跳过分析 → 引用不计入重命名范围
实操建议：把光标停在 import 行的函数名上，按 Ctrl+Click 尝试跳转；跳不到 = 语言服务没认出这个引用，重命名自然不会动它。
Python 重命名后 from ... import 失效？
这是 Pylance 的设计行为，不是 bug。当你在 a.py 中写 from b import func，再对 a.py 里的 func 按 F2，Pylance 默认只改 a.py 内部所有 func 的使用，**不会反向修改 b.py 里的 def func() 定义**，也不会自动更新 from b import func 这行。
- 要改定义本身，光标必须落在
b.py的def func()上，再按 F2 - 重命名完成后，手动用
Ctrl+Shift+F搜旧名字（关掉正则），重点检查所有from ... import和import ... as行 - 禁用
from module import *—— Pylance 对这种写法完全无法追踪来源，重命名基本失效
常见信号：状态栏显示 “Plain Text” 或右下角没出现 “1 definition, X references”，说明 Pylance 根本没接管当前文件。
字符串拼接、动态访问、any 类型一定漏改
语言服务只做静态分析，以下写法永远不在 F2 重命名范围内，必须人工检查：
-
obj["user" + "Name"]→ 键名由字符串拼接生成，无法推导 -
const key = "userName"; obj[key]→ 属性名来自变量，非字面量 -
const x: any = {}; x.userName→any关闭类型检查，符号关系断裂 -
JSX中未声明的 prop：<usercard username="x"></usercard>，若组件类型没定义username: string，就不算符号引用 -
eval()、new Function()、obj[methodName]()→ 动态调用，LSP 直接放弃分析
这些不是“功能不完善”，而是静态分析的天然边界。指望 F2 覆盖它们，等于让编译器读懂运行时才决定的事。
重命名后报错但找不到哪没改？先看这三处
很多“报错”其实源于局部遗漏，而非跨文件失败。优先排查：
-
import语句本身：比如从utils.ts重命名函数后，其他文件里import { oldName } from './utils'没同步更新 - 类型提示中的类/接口名：如
function handle(user: User)，重命名User类后，这里若没变，大概率是 Pylance 或 TS Server 没解析到User的定义路径（查pyproject.toml的extraPaths或tsconfig.json的baseUrl） - 构建配置或测试文件：
jest.config.js、vite.config.ts、__tests__/下的 mock 引用，这些常被忽略但会直接导致运行时报错
最省事的兜底动作：重命名后执行一次全局搜索 Ctrl+Shift+F，搜旧符号名，关闭正则，逐个确认是否应被替换——别信“已全部更新”的提示框。
