vscode本身不执行静态检查,所有标红、修复均依赖插件与本地配置协同;必须打开项目根目录、本地安装eslint并生成配置、协调eslint与prettier规则。

VSCode 本身不执行任何代码静态检查,所有标红、波浪线、自动修复都依赖插件 + 项目本地配置协同工作;没装对、没配对、没打开根目录,插件就等于没装。
ESLint 插件没反应?先查这三件事
ESLint 插件静默失效,90% 是它根本没加载到项目规则。不是插件坏了,是它找不到配置或依赖。
- 打开命令面板
Ctrl+Shift+P→ 输入Developer: Toggle Developer Tools→ 看 Console 是否报Cannot find module 'eslint'或No ESLint configuration found - 确认 VSCode 当前打开的是**项目根目录文件夹**(比如
/my-project),不是子目录(如/my-project/src)——否则插件找不到node_modules/eslint和.eslintrc.cjs - 必须本地安装 ESLint:
npm install --save-dev eslint(禁用-g全局安装),再运行npx eslint --init生成配置;手动新建空.eslintrc.js极易漏掉parser或env配置
保存自动修复但格式越修越乱?ESLint 和 Prettier 在打架
两者都管缩进、引号、分号,不协调就会反复格式化、波浪线不消失,甚至把 const a = 1; 改成 const a = 1 ;。
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
- 必须安装
eslint-config-prettier,并在.eslintrc.cjs的extends中把它放在最后:["eslint:recommended", "plugin:prettier/recommended"] -
.prettierrc必须存在且内容合法(纯 JSON 或 JS 导出,不能带注释),路径必须是项目根目录 - VSCode 设置里只开
"source.fixAll.eslint": true,**禁用**"source.fixAll.prettier";Prettier 应仅作为 formatter,不参与 lint 修复逻辑
拼写检查只标红注释、不标变量名?这不是 bug
Code Spell Checker 默认跳过标识符(变量、函数、类名),只查字符串字面量、注释和 Markdown 文本——因为技术词太多,全查会满屏误报。
- 想让中文注释不被误标:在
settings.json加"cSpell.language": ["en", "zh-cn"]和"cSpell.allowCompoundWords": true - 项目专属词(如
zustand、vitepress)要加进项目级.cspell.json的words字段,别点「添加到用户词典」——那会污染所有项目 - CI 环境里插件完全不工作,必须用 CLI:
npx cspell --no-progress "**/*.{js,ts,md}" --ignore="node_modules/**"
真正卡住的点往往不在插件本身,而在项目根目录是否打开、node_modules 是否存在、配置文件是否被正确识别——这些细节一错,整个静态检查链就断了。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










