ESLint 与 Prettier 必须配对启用并解耦配置,否则保存时会因规则冲突导致格式错乱;需在 .eslintrc.js 中引入 plugin:prettier/recommended 并安装 eslint-config-prettier 消除冲突,VSCode 仅识别标准命名的配置文件,.vscode/settings.json 仅允许写代码质量相关项。

VSCode 插件不是堆得越多越好,项目结构也不是越深越规范。真正起作用的,是插件与项目结构之间是否形成可复用、可验证、不互相干扰的协作关系。
eslint 和 prettier 插件必须配对启用,否则会互相覆盖
单独装 ESLint 或只开 Prettier 插件,保存时大概率出现格式错乱或规则失效。根本原因是:ESLint 默认自带部分格式规则(比如 semi、quotes),而 Prettier 会按自己逻辑重排代码,两者若未解耦,就会反复拉扯。
- 必须在
.eslintrc.js中显式引入prettier和plugin:prettier/recommended,禁用 ESLint 的格式类规则 -
settings.json里要同时开启"editor.formatOnSave": true和"editor.codeActionsOnSave": { "source.fixAll.eslint": true } - 不要把
eslint-config-prettier当成可选依赖——它是消除冲突的必要中间层,漏掉就等于没配
项目根目录下 .vscode/settings.json 不该放个人偏好配置
团队协作中,.vscode/settings.json 常被误用来存字体大小、主题色这类纯本地设置,结果导致别人 clone 项目后编辑器行为异常,甚至 lint 报错位置偏移。
详细的 Three.js 3D 图形参考,涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
- 只允许写与代码质量强相关的项:
editor.defaultFormatter、editor.formatOnSave、eslint.validate - 禁止写
editor.fontSize、workbench.colorTheme等 UI 类配置——这些应由用户全局设置管理 - 如果项目需特殊路径映射(如
webpack别名),应统一用jsconfig.json或tsconfig.json,而非靠插件 hack
node_modules 下的插件不能替代项目级配置文件
有些开发者图省事,在 package.json 里写 "eslintConfig" 或直接用 eslint --fix 命令行跑,却忽略 VSCode 插件实际读取的是项目根目录下的 .eslintrc.* 文件。一旦路径不对或文件名拼错(比如写成 .eslintrc 少了后缀),插件就静默失效。
- VSCode 的 ESLint 插件默认只认
.eslintrc.js、.eslintrc.json、.eslintrc.yaml这三种命名,其他一概忽略 -
package.json中的eslintConfig字段仅对 CLI 生效,VSCode 不读它 - 如果项目用了 monorepo 结构(如
packages/foo),每个子包必须有自己的.eslintrc.js,不能指望根目录配置自动继承
最常被忽略的一点:插件本身不会“理解”你的项目结构,它只机械地按配置路径找规则文件、按语言模式触发检查。结构设计得再漂亮,只要配置文件放错位置或命名不标准,整个链路就断在第一步。

















