VS Code中重命名文件需在资源管理器中右键选Rename或按F2/Enter，确认用Enter；TypeScript/JS需启用对应updateImports设置且文件在工作区内才自动更新import路径。
在 VS Code 里直接重命名文件的正确操作
VS Code 不支持像操作系统那样双击文件名直接编辑，必须通过资源管理器右键或快捷键触发重命名流程。点错位置、没选中文件、或在错误视图下操作，都会导致重命名失败。
- 确保你在 资源管理器（Explorer）面板 中，鼠标悬停在目标文件上（不是在编辑区、也不是在搜索结果里）
- 右键该文件 → 点击
Rename；或者选中文件后按F2（Windows/Linux）或Enter（macOS） - 输入新名字后，必须按
Enter确认，按Esc会取消操作 - 如果文件正在被编辑且有未保存更改，VS Code 会提示是否同步更新引用（比如 TypeScript 的 import 路径），此时要留意是否勾选
Also update imports
重命名后 import 路径没自动更新？检查这些设置
VS Code 默认只对部分语言（如 TypeScript、JavaScript）提供 import 路径自动修正，但需要满足前提条件，否则你改完文件名，代码里还是旧路径，运行时直接报错。
- 确认工作区已启用
"javascript.updateImportsOnFileMove.enabled": true或"typescript.updateImportsOnFileMove.enabled": true（在settings.json中） - 文件必须属于当前打开的项目（即在 VS Code 工作区根目录下），跨工作区或未添加到工作区的文件不会触发自动更新
- 仅支持相对路径（如
./utils.ts），不处理绝对路径（@/components/...）或别名路径（除非配置了jsconfig.json/tsconfig.json的baseUrl和paths） - 如果用了 ESLint + Import Plugin，可能因缓存延迟一两秒才高亮错误，别急着手动改
遇到 “Cannot rename file” 错误怎么办
这个错误通常不是权限问题，而是 VS Code 检测到潜在冲突，比如同名文件已存在、文件被外部进程占用、或路径含非法字符。
- 检查目标目录下是否已有同名文件（包括大小写不同，如
File.ts和file.ts在 macOS/Linux 可能冲突） - 关闭终端里正在运行的
npm run dev、tsc --watch或其他监听文件变动的进程 - 避免在文件名中使用
:、*、?、"、、<code>>、|（Windows 禁止），VS Code 会直接拦截 - 如果文件在 Git 仓库中且有未提交变更，重命名可能触发 Git 重命名检测失败，建议先
git add或暂存变更再操作
批量重命名多个文件？别用 VS Code 原生功能
VS Code 不支持多选文件后统一重命名（比如把 a.js、b.js 同时改成 a.test.js、b.test.js）。强行操作只会重命名第一个选中的文件。
- 真正想批量处理，请用命令行：
rename 's/\.js$/.test.js/' *.js（Linux/macOS）或 PowerShell：Get-ChildItem *.js | Rename-Item -NewName { $_.Name -replace '\.js$', '.test.js' } - 或者安装扩展，比如
multi-command配合自定义任务，但复杂度远超原生需求 - VS Code 的“查找替换”（
Ctrl+Shift+H）只能改内容，不能改文件名——这点常被误以为能替代重命名
