真正提升js重构效率的关键是厘清vs code原生能力与插件的边界：renamesymbol仅支持静态声明与引用，跨文件更新受限；auto import与eslint需协同配置；必须开启editor.renameontype、禁用自动import、配好prettier格式化；webpack别名、jest路径、文档注释等非代码层依赖须手动排查。
真正提升 JS 重构效率的，不是装一堆插件，而是搞清哪些操作必须靠插件兜底、哪些靠原生功能就能稳准快。很多开发者花时间配插件却卡在 rename 失效、import 错乱、跨文件更新漏改上，问题不在插件没装全，而在没理清边界——哪些是 VS Code 原生能做的，哪些必须靠插件补足。
VS Code 原生重命名 renameSymbol 的真实能力边界
按 F2 重命名变量/函数时，VS Code 默认只处理当前语言作用域内的引用。它能跨文件更新，但有几个硬限制：
- 不识别字符串拼接的动态引用（比如
const key = 'user' + 'Name'; obj[key]） - 对
require()或import()动态导入路径中的符号名无感知 - 不会自动同步更新 HTML 模板里绑定的
{{ user.name }}或 JSX 中的{user.name}（除非项目已启用 Volar/Vetur 等框架插件） - 遇到
eval()、new Function()这类运行时解析代码，直接跳过
也就是说，renameSymbol 可靠的前提是：符号被静态声明、静态引用、且类型系统可推导。TypeScript 项目成功率远高于纯 JS。
Auto Import 和 ESLint 配合时的 import 冲突点
当 Auto Import 自动补全 import { debounce } from 'lodash'，而 ESLint 规则要求使用 lodash-es 时，两者会打架。常见表现是保存后 import 行被 ESLint 自动删掉或改写，接着 Auto Import 又弹出来补。
Miller CSV TSV JSON 数据处理器
下载
Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。
- 解决办法：在
settings.json中关掉auto-import的自动触发，只保留手动快捷键Ctrl+.（Windows/Linux）或Cmd+.（macOS） - 确保
eslint.enable为true，且项目根目录有.eslintrc.js显式配置import/resolver指向node或webpack - 若用
lodash-es，在 ESLint 配置里加规则："import/no-extraneous-dependencies": ["error", {"devDependencies": false, "optionalDependencies": false}]，避免误报
重构前必须检查的三个配置开关
很多重构失败，其实只是 VS Code 的基础开关没打开：
-
editor.renameOnType：设为true，光标停在变量上打字时自动触发重命名（默认关闭） -
javascript.suggest.autoImports和typescript.suggest.autoImports：设为false，否则自动 import 会干扰手动组织 import 顺序 -
editor.formatOnSave：设为true，但必须配合editor.defaultFormatter指向esbenp.prettier-vscode，否则保存时格式错乱
这三个开关不调好，装再多插件也白搭——重命名卡住、import 乱序、保存后代码缩进崩坏，全是它们在背后捣鬼。
JS 重构中最容易被忽略的「非代码层」依赖
重构函数名或模块路径时，真正难处理的往往不是代码本身，而是这些地方：
- Webpack / Vite 配置里的
resolve.alias（比如@/utils指向src/utils），改了路径但忘了同步 alias - Jest 测试文件中硬编码的
require('../src/utils/oldName')，不在 TypeScript 类型检查范围内 - 文档注释里的
@see {@link oldFunctionName}，ESLint 和 Prettier 都不会管 - CI 脚本中写死的路径或命令，比如
npm run lint -- --fix src/oldDir/
这些地方没有语法高亮、不进 AST、不被任何插件扫描，只能靠 grep 或 ripgrep 手动搜 oldFunctionName ——别指望插件替你兜底。
