VSCode的rename symbol（F2）无法跨项目重命名，因其语言服务按单项目根目录独立运行，多根工作区仅并列展示文件夹而不共享符号表；需统一tsconfig.json/jsconfig.json、共用包结构或改用全局替换加人工校验。
跨项目重命名在 VSCode 中无法自动实现——rename symbol（F2）默认只作用于当前语言服务能解析的单一项目边界内，即使你用了多根工作区（.code-workspace），它也不会跨 folders 里的不同项目做语义关联。
为什么多工作区 ≠ 跨项目重命名
多根工作区只是把多个文件夹“并列展示”在一个窗口里，共享设置和终端，但每个子文件夹仍是独立的语言服务实例。TS/JS 的 tsserver、Python 的 pyright 都按各自项目根目录加载配置（如 tsconfig.json 或 pyproject.toml），彼此不打通符号表。
- 你在
backend/里重命名一个UserService类，frontend/中的import { UserService } from '@api'不会变——因为前端语言服务根本不认识后端源码路径 -
Find All References（Shift+F12）在多工作区中仍只查当前打开的子文件夹，不会扫描其他folders下的引用 - 右下角语言模式显示的是当前活动编辑器所属项目的语言，切换标签页时语言服务上下文也跟着切换
哪些情况能“伪跨项目”重命名
只有当多个项目实际被同一个语言服务视为“同一工程”时，F2 才可能穿透边界。这需要人为构造统一的语义上下文：
- TypeScript：所有子项目共用一个顶层
tsconfig.json，且"references"字段正确声明了项目引用关系（即composite: true+references数组） - JavaScript：必须有统一的
jsconfig.json，且所有子项目路径被"include"覆盖（例如"include": ["backend/**/*", "frontend/**/*"]），不能靠多个分散的jsconfig.json - Python：需把多个子目录设为同一包结构，通过
pyproject.toml的[tool.setuptools.packages]或src-layout声明，并确保pyright启用了useLibraryCodeForTypes - 所有情况都要求：这些子目录必须在同一个 Git 仓库下，且 VSCode 是以该仓库根为工作区打开的——而不是靠
.code-workspace拼凑
真要改多个项目里的同名符号，怎么办
放弃 F2，转向可控的文本级批量操作，但必须加约束防止误伤：
- 用
Ctrl+Shift+H（全局替换），在files to include栏明确填入路径模式，例如：backend/**/*.ts,frontend/**/*.ts,shared/**/*.ts - 务必勾选
Match Case和Whole Word；若涉及下划线转驼峰等规则，启用正则：\buser_name\b→userName - 先点
Find in Files（Ctrl+Shift+F）预览全部匹配项，重点检查是否出现在字符串、注释、JSON 键或 import 路径中 - 对 import 语句单独处理：比如从
import { foo } from 'legacy-utils'改成from 'modern-utils'，不能靠重命名，得用JavaScript Refactor插件或手动 +Ctrl+Click验证路径有效性 - 改完立刻运行
git diff，逐行确认每处变更——尤其是跨项目调用处的类型导入、API 路径、环境变量键名
真正难的不是怎么改，而是判断“该不该一起改”：两个项目里都叫 ConfigService，未必是同一概念；一个导出的是 class，另一个是 factory 函数，强行统一名称反而掩盖语义差异。多工作区帮你看到它们并存，但不会替你做架构决策。
