JS重命名失效主因是语言服务未就位或命令被插件抢占。需检查jsconfig.json配置、路径别名声明，控制台搜索rename报错，用扩展二分法定位冲突插件，并规范导出/导入写法。
JS 重命名功能失效？先确认语言服务器是否就位
VSCode 的 F2 重命名不是万能的，它依赖后端语言服务提供准确的符号解析。TypeScript 和 JavaScript 默认用 tsserver，但纯 JS 项目若没配 jsconfig.json，或路径别名（baseUrl/paths）没声明，跨文件引用就可能找不到——重命名只改当前文件，其他地方不动，看起来像“冲突”，其实是识别失败。
检查点：
- 项目根目录是否存在
jsconfig.json？哪怕空对象{}也能激活基础 JS 支持 - 如果用了
import别名（如@/utils），必须在jsconfig.json里写明"compilerOptions": { "baseUrl": ".", "paths": { "@/*": ["src/*"] } } - 打开命令面板
Ctrl+Shift+P，运行Developer: Toggle Developer Tools，Console 里搜rename或no definition，看是否有语言服务报错
多个插件抢注册 rename 命令？控制台一眼定位
当你按 F2 没反应、右键菜单缺“Rename Symbol”，或重命名后只改局部变量不改引用——大概率是插件抢注了 editor.action.rename 命令。VSCode 只保留最后一个加载成功的，前面的被静默丢弃。
验证方式：
wechat-article-extraction-mp-weixin-qq-com news-webpage-cleaning blog-post-parsing metadata-extraction-title-author-date multiple-output-formats-markdown-json-plain-text batch-processing-support
下载
基于三引擎设计，从微信文章、新闻和博客网页提取干净内容，支持标题作者日期元数据，多格式和批量处理。
- 打开
Ctrl+Shift+I→ Console 标签页，搜索Command 'editor.action.rename' - 若看到类似
Extension 'esbenp.prettier-vscode' contributed command 'editor.action.rename' but it's already registered，说明有插件越权注册 - 运行
Developer: Start Extension Bisect，按提示“是/否”复现问题，3–4 轮就能锁定冲突插件 - 特别注意旧版
ms-python.python或某些“JS增强包”，即使禁用也可能在启动阶段抢先注册
重命名后引用没更新？别急着删插件，先查 workspaceEdit 范围
语言服务器返回的 WorkspaceEdit 决定哪些位置会被改。常见漏改原因不是插件冲突，而是语义边界判断失败：
- 导出/导入语句写法不规范：比如
export const foo = () => {}能被识别，但const foo = () => {}; export { foo }在部分配置下可能漏掉foo引用 - 动态 import 或 require 场景：
import(`./${name}.js`)这类字符串拼接，任何语言服务器都无力解析，重命名不会碰它 - TSX/JSX 中 JSX 属性值（如
<button type="primary"></button>）不属于符号引用，F2不处理 - 确保
"editor.renameOnType": true开启，否则光标停在变量上也不会自动触发预览
真要规避命名冲突，靠插件不如靠配置和习惯
所谓“规避命名冲突”，本质是减少同名标识符在作用域内出现的概率。插件只能辅助重命名，不能替代设计意识：
- 避免裸导出函数/变量：用
export default { foo, bar }或命名空间对象封装，降低顶层命名污染 - 模块级变量加前缀：比如工具函数统一用
utilFormatDate而非formatDate，配合 ESLint 规则"no-shadow": "error"防止块级重复 - 禁用
javascript.validate.enable，交由 ESLint 全权校验——VSCode 自带 JS 校验器对模块解析极弱，常误报“未定义”引发手动补全，反而引入拼写错误 - 团队统一启用
eslint-plugin-import的no-duplicates规则，防止同一模块被多次import导致变量覆盖
重命名功能本身很稳，出问题基本卡在语言服务没加载、命令被抢、或代码写法超出静态分析能力——盯着控制台报错比装十个“智能重命名”插件管用得多。
