VSCode不支持批量重命名关联文件，因editor.action.rename仅作用于语言符号，不识别文件路径关系；需用shell脚本或PowerShell按显式规则批量处理，并手动更新所有引用路径。
VSCode 本身不支持“批量重命名关联代码文件”这一操作——所谓“关联文件”，比如 user.ts 和 user.test.ts、api.service.js 和 api.service.spec.js，它们之间没有语言服务定义的语义关系，VSCode 不会自动识别或联动重命名。
为什么 editor.action.rename 对文件名完全无效
你光标停在 import { User } from './user' 里按 F2，只会尝试重命名符号 User，不会碰 user.ts 这个文件名；同理，在资源管理器中多选 user.ts 和 user.test.ts 后按 F2，输入新名字（如 profile.ts），两个文件都会被改成同一个名字，不是按规则映射（user.test.ts → profile.test.ts）。
-
editor.action.rename只作用于语言服务解析出的符号（变量、函数、类等），对路径字符串、文件系统实体零感知 - 资源管理器里的
F2是系统级文件重命名，无逻辑、无上下文，不区分“主文件”和“测试文件” - 插件如
File Utilities或multi-command本质仍是逐个调用fs.rename，无法自动推导关联关系
真正可行的批量关联重命名：靠 shell 脚本 + 显式规则
必须手动定义“哪些文件算关联”，然后用终端命令批量处理。VSCode 集成终端（Ctrl+`）就是你的执行环境，无需切出。
- Linux/macOS 示例：把所有
*.service.js和对应*.service.spec.js改为*.api.js和*.api.spec.js
for f in *.service.js; do
[[ -f "$f" ]] || continue
base=${f%.service.js}
echo mv "$f" "${base}.api.js"
echo mv "${base}.service.spec.js" "${base}.api.spec.js"
done
先加 echo 预览，确认输出无误后再删掉 echo 执行
- PowerShell 示例：匹配
user.*.ts并统一改为profile.*.ts
Get-ChildItem user.*.ts | ForEach-Object {
$newName = $_.Name -replace '^user.', 'profile.'
echo "Rename-Item $($_.FullName) -NewName '$newName'"
}
注意：-replace 是 PowerShell 原生命令，^user. 中的点要转义
- 关键原则：先
ls user.*.ts或Get-ChildItem user.*.ts确认范围，再写循环；路径含空格必须用"$f"包裹
别指望插件自动识别“关联”，它连大小写都容易搞错
像 File Utilities 这类插件虽支持正则，但默认忽略隐藏文件、区分大小写、不校验目标文件是否存在——想把 README.md 改成 Readme.md，它可能直接跳过（因原始是大写），或报错找不到源文件。
- 启用正则时捕获组用
，不是$1（VSCode 编辑器内是$1，插件语法不同） - 插件无 dry-run 模式，出错后只能手动恢复，不如脚本加
echo安全 - 嵌套目录下（如
src/api/user/）插件常漏文件，而find . -name "user.*.ts" -exec ... ;更可靠
改完文件名后，引用不会自动更新——这是最容易被忽略的致命点
你用脚本把 user.service.ts 改成 profile.service.ts，但所有 import 语句、require 字符串、jest.mock('./user.service') 全部还是旧路径，VSCode 不会提示，也不会修复。
- 必须手动运行
Ctrl+Shift+H全局搜索'./user.service'或"./user.service"，用正则替换为'./profile.service' - 注意引号类型（单/双）、路径分隔符（
/vs\）、是否带后缀，否则漏改 - 如果项目启用了
typescript.updateImportsOnFileMove.enabled，它只对单个文件拖拽重命名生效，对批量脚本改名完全无响应
真正麻烦的从来不是改名动作本身，而是那些没立刻爆红、却在运行时或 CI 中突然失效的硬编码路径引用。
