prettier与eslint需分工协作：prettier负责排版，eslint负责代码质量；须安装eslint-config-prettier并置于extends末尾以禁用格式规则，vs code中设prettier为默认格式化工具且避免prettierrc与团队规范冲突。

prettier 保存即格式化，但别让它和 eslint 对着干

装了 Prettier 却发现保存后代码越改越乱？大概率是 eslint 在后台偷偷执行了冲突规则。它俩本该分工：Prettier 负责“怎么排版”，eslint 负责“写得对不对”。一旦重叠（比如都管分号、引号），就会互相覆盖。

• 必须在项目里装 eslint-config-prettier，并在 .eslintrc.js 的 extends 中把它放在最后，显式关掉所有格式类规则
• VS Code 设置里打开 "editor.formatOnSave": true，但要确认默认格式化工具设为 Prettier，不是 ESLint
• .prettierrc 里别写 "semi": false 这种和团队规范相反的配置——格式化不是个人自由，是协作契约

auto rename tag 改一个标签名，闭合标签却没动

你在 Vue 或 JSX 里重命名 <mycomponent></mycomponent>，结果 没同步？不是插件坏了，是它只响应“标签名本身”的修改，不识别属性或注释里的文字。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 只对标准 HTML/XML 标签结构生效；<div id="app"> → <code><section id="app"></section> 会同步闭合标签，但 <div classname="app"> 不会（因为 <code>className 不是标签名）
• React 中若用自定义 hook 名如 useFetchData，改名时不会触发该插件——它不管 JS 变量，只管模板里的成对标签
• 如果用了 Pug 或 Svelte 等非标准模板语法，这个插件直接不工作，别硬套

path intellisense 配了 alias 却补全不出来

你明明在 jsconfig.json 里写了 @/components 映射到 src/components，输入 import 时还是只能看到相对路径？问题常出在配置位置或 VS Code 缓存上。

• jsconfig.json 必须放在项目根目录，且文件名不能是 tsconfig.json（即使你是 TS 项目，也要确保 jsconfig.json 存在并被识别）
• 配置中的 baseUrl 值必须是 "."，不能是 "./" 或空字符串；paths 的 key 必须以 / 结尾（如 "@/*"），否则匹配失败
• 改完配置后按 Ctrl+Shift+P 输入 Developer: Reload Window 强制刷新语言服务，别只重启编辑器

gitlens 行内看提交人，但 hover 没反应

GitLens 左侧 gutter 显示了作者头像，可鼠标悬停却不出 commit 信息？通常不是插件没装好，而是当前文件还没被 Git 跟踪，或者工作区处于“未暂存”状态。

• 新建的 .js 文件如果还没 git add，GitLens 就查不到任何历史——它依赖 Git 索引，不是文件系统扫描
• 如果你在 WSL 或远程 SSH 环境下开发，确认 VS Code 连接的是目标机器上的 Git，而不是本地 Windows 的 Git（路径、用户、SSH key 都可能错位）
• 某些 monorepo 场景下，GitLens 默认只认项目根目录的 .git，若你在子包里编辑，需右键文件 → GitLens: Show File History 手动触发
有些插件看似开箱即用，实则对项目结构、Git 状态、甚至当前焦点文件类型高度敏感。配错一行 JSON、漏 reload 一次窗口、或多建了一个子目录，就足以让功能静默失效——这不是 bug，是它们本来就被设计成“只在明确上下文中才出手”。