VSCode必备神级插件有哪些 - 2024年最受欢迎的提升效率扩展盘点
eslint 与 prettier 需分工协作:eslint 负责逻辑与规范检查,prettier 专管格式化;通过配置 eslint-config-prettier 关闭 eslint 格式规则,并在 vscode 中禁用 eslint.format.enable、启用 prettier 为默认格式化器,可避免冲突。

ESLint + Prettier 怎么配才不打架
ESLint 检查代码逻辑和规范,Prettier 负责格式排版,两者默认规则会冲突——比如 ESLint 要求分号,Prettier 默认删分号,保存时反复拉扯,光标乱跳、报错红波浪线不断闪。
- 先装插件:
ESLint(Microsoft 官方)和 Prettier - Code formatter,别用其他同名非官方版本
- 项目根目录运行
npx eslint --init 生成 .eslintrc.cjs,选“JavaScript modules (import/export)”和“Node”环境,最后一步选“JSON”或“JavaScript”都行,但别跳过
- 在
.eslintrc.cjs 的 extends 数组里加 'prettier',再额外安装 eslint-config-prettier 并加入 extends,顺序必须是:自定义规则 → eslint-config-prettier → prettier
- VSCode 设置中启用
editor.formatOnSave,并设 editor.defaultFormatter 为 esbenp.prettier-vscode;同时关掉 eslint.format.enable(它只该做检查,不该抢格式化权)
Auto Rename Tag 改了 <div> 为什么 <code>
没同步
常见于 Vue/JSX 文件里标签嵌套深、或用了自定义组件名(如 <mybutton></mybutton>),插件默认只对 HTML 标准标签生效,且依赖语言模式识别是否准确。
- 确认当前文件右下角显示的是
Vue 或 JavaScript React,不是 Plain Text 或 HTML;点一下切换正确语言模式
- 检查设置里
auto-rename-tag.activationOnLanguage 是否包含 vue 和 javascriptreact,默认值可能只含 html
- 如果用了 JSX 片段(如
rfc 快捷生成函数组件),确保 Auto Rename Tag 插件是最新版(2025 年后已支持 JSX 闭合标签自动更新)
- 别在
template 外的 script 区域期待它工作——它只管模板结构,不管 JS 变量名
Path Intellisense 提示路径时总漏掉 src/utils 这类深层目录
不是插件坏了,而是它默认只扫描当前打开文件夹下的直接子目录,遇到软链、符号链接、或未在 VSCode 工作区里显式包含的子文件夹,就会“看不见”。
VSCode
避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。
下载
- 打开 VSCode 左侧资源管理器,右键项目根文件夹 →
Add Folder to Workspace,确保所有要用的模块目录都在工作区范围内
- 如果用了
tsconfig.json 或 jsconfig.json 配置了 baseUrl 和 paths,Path Intellisense 默认不读这些——得手动在 settings.json 里加 "path-intellisense.mappings" 映射
- 例如:
"path-intellisense.mappings": { "@": "${workspaceFolder}/src", "@utils": "${workspaceFolder}/src/utils" }
- 注意:
node_modules 内包名补全是开箱即用的,但自定义别名必须显式配置,否则输入 import xxx from '@utils/xxx' 时不会提示
GitLens 行内 blame 显示 “No author info”
不是 GitLens 没装好,而是当前文件没被 Git 跟踪,或者你正编辑的是未提交的新建文件、暂存区外的修改、或分支上某次 rebase 后的孤立提交。
- 执行
git status 确认文件状态:如果是 untracked,先 git add .;如果是 modified 但没 git add,blame 仍可能为空
- 检查 VSCode 底部状态栏是否显示了正确的 Git 分支名,如果显示
No source control providers,说明没识别到 Git 仓库——确认项目根目录有 .git 文件夹
- GitLens 默认只显示最近一次 commit 的作者信息,若某行是刚改的、还没 commit,就显示空白;按
Ctrl+Shift+P 输入 GitLens: Toggle Blame Annotations 可强制刷新
- 团队协作中,如果同事用
--author 覆盖了提交作者,而你本地没配置 user.name/email,也可能导致 blame 显示异常
真正卡住人的,往往不是插件装不装,而是装完后没意识到 ESLint 和 Prettier 的控制权要切分清楚、GitLens 的 blame 依赖真实 commit 记录、Path Intellisense 的映射得手动写进 settings —— 这些地方一漏,插件就“失灵”,但错误又不报,只能靠排查意识兜底。