VS Code 无法安全重命名文件夹，因其资源管理器仅为只读快照，右键重命名实为调用易失败的 fs.renameSync，不更新 Git、终端路径、插件缓存及 import 引用；必须通过系统资源管理器重命名，并关闭工作区、重新执行 code .、手动检查配置与引用。
VSCode 本身不支持安全的文件夹重命名——所谓“右键 → 重命名”只是调用底层 fs.renameSync，跨设备、符号链接、权限受限时大概率失败，且不会更新 Git 索引、终端当前路径、插件缓存或 import 引用。真要改文件夹名，必须走操作系统级操作。
为什么不能在 VS Code 里直接重命名文件夹
VS Code 的资源管理器只是文件系统的只读快照，它没有权限或机制去协调整个开发环境对路径变更的响应。常见后果包括：
-
Error: EXDEV: cross-device link not permitted：从 SSD 改名到外接硬盘时必然报错 -
git status显示大量deleted:和new file:，因为 Git 认为原文件夹被删、新文件夹是全新内容 - 终端中仍停留在旧路径（
pwd显示正常但实际失效），code .打开的仍是旧工作区 - ESLint、Prettier、TypeScript Server 等插件继续读取旧路径缓存，重启前无法识别新结构
正确做法：系统级重命名 + 后续手动补救
分三步走，缺一不可：
- 先关闭 VS Code 中该工作区（不是关编辑器，是关掉对应窗口/工作区）
- 在文件资源管理器（Windows 资源管理器 / macOS Finder / Linux Nautilus）中右键文件夹 → 重命名为新名字
- 重命名后，重新进入新文件夹执行
code .；若之前用过终端命令如npm run dev，需手动 cd 进新路径再启动
补充检查项：
- 如果项目有
package.json，确认name字段是否需同步更新（尤其发布到 npm 时） - 检查
tsconfig.json或jsconfig.json中的baseUrl、paths是否仍指向有效路径 - 运行
lsof +D ./new-folder-name（macOS/Linux）或handle.exe new-folder-name（Windows）确认无残留进程占用
哪些“自动更新”根本不存在
别信“VS Code 会自动更新所有引用”这类说法——它做不到：
- import 路径：仅对单个文件重命名时才可能触发
typescript.updateImportsOnFileMove.enabled，文件夹重命名完全不触发 - 硬编码字符串中的路径：比如
require('./old-folder/utils')或fetch('/api/old-folder/data')，零自动修复 - 配置文件里的路径：
webpack.config.js、jest.config.ts、.eslintrc.cjs全部得人工 grep + 修改 - Git 分支名、标签、CI 脚本中的路径引用：这些和 VS Code 无关，但常被忽略
真正麻烦的从来不是改个名字，而是那些没立刻报错却悄悄坏掉的引用——它们往往在部署后、CI 失败时、或者某天你换电脑重装环境时才浮出水面。
