重命名模块名必须通过文件系统重命名操作，F2仅更新符号引用；正确做法是在资源管理器中右键文件选择“重命名”，启用updateImportsOnFileMove.enabled并确保有tsconfig.json/jsconfig.json，确认弹窗更新导入路径。
重命名模块名必须走文件系统操作，不是F2能解决的
VSCode 的 F2 重命名只改符号引用，不改文件名或模块路径。想把 utils.js 改成 helpers.js，同时让所有 import 和 require 自动更新，不能靠 Rename Symbol——它压根不处理文件级模块标识。
移动文件时用 VSCode 内置“重命名文件”功能
这是唯一安全触发跨文件 import 路径自动修正的方式。
- 在资源管理器中右键点击目标文件（如
src/utils.js），选择重命名（或按F2，注意：这是文件系统的 F2，不是编辑器里的） - 输入新文件名（如
helpers.js），回车 - VSCode 会自动扫描项目中所有 import/require 语句，并弹出预览窗口列出所有将被更新的路径
- 确认无误后点击
应用；若某处 import 是动态拼接（如require(`${name}.js`)）或字符串形式（如"./utils"未加扩展名），则不会被识别，需手动修复
为什么 JavaScript Refactor 插件比原生更可靠
VSCode 原生的文件重命名对 CommonJS、混合模块语法（import + module.exports）、别名路径（@/utils）支持有限，容易漏改或改错大小写。
- 安装
JavaScript Refactor（作者 micnic），启用后移动文件会自动触发Update imports for moved file - 它能正确处理
import { foo } from "./utils"→import { foo } from "./helpers"，包括带扩展名和不带扩展名的写法 - 对
webpack.alias或jsconfig.json中配置的路径别名也具备基础识别能力（需项目已加载） - 不支持 TypeScript 类型导入（
import type { X } from "./utils"）的自动更新，这类仍需手动检查
重命名后必查的三个地方
哪怕用了插件，模块名变更仍可能留下隐患。
- 检查
git diff中是否出现意外修改：比如某处import * as utils from "./utils"被改成import * as helpers from "./helpers"——变量别名也被顺手改了，这通常不是你想要的 - 搜索项目中所有未被 import 语句包裹的字符串字面量，例如日志、测试用例中的
"utils"、__dirname + "/utils"，这些永远不会被任何重构工具捕获 - 运行
npm run build或启动开发服务器，确认没有Cannot find module报错；TypeScript 项目还要看tsc --noEmit是否报路径解析失败
模块重命名本质是文件系统 + 模块解析器 + 构建工具三者协同的结果，语言服务器只管语义，不管路径。最容易忽略的是构建配置里硬编码的路径，比如 Vite 的 resolve.alias 或 Webpack 的 resolve.modules，它们不会随文件移动自动更新。
