关键在于精选核心插件、配置基础规则并确保VSCode真正理解React:必备ESLint、Prettier、Auto Import等插件,配合settings.json和.vscode目录下的团队一致配置,兼顾效率、质量与协作。

用 VSCode 开发 React 项目,关键不是装得越多越好,而是选对核心插件、配好基础规则、让编辑器真正“懂” React。下面这套配置经过大量实际项目验证,兼顾开发效率、代码质量与团队协作一致性。
必备插件:轻量但精准
只装这几个,覆盖语法高亮、智能提示、格式化和调试全流程:
-
ESLint:配合项目中的
.eslintrc.js实时报错,推荐使用eslint-config-react-app或@typescript-eslint/recommended(TS 项目) -
Prettier:统一格式化风格,和 ESLint 配合使用(通过
eslint-config-prettier关闭冲突规则) - Auto Import:自动补全并插入 import 语句,支持 React/TSX 组件、hooks、工具函数
- Bracket Pair Colorizer 2(或 VSCode 1.79+ 内置的括号高亮):快速识别 JSX 嵌套层级
-
Reactjs Code Snippets:常用快捷片段,如
rfc(函数组件)、usee(useEffect)、usel(useLayoutEffect)
关键设置:让 VSCode 真正理解 React
在 settings.json 中加入这些配置,避免常见坑:
-
"javascript.preferences.importModuleSpecifier": "relative":导入路径保持相对,避免绝对路径混乱 -
"editor.formatOnSave": true和"editor.codeActionsOnSave": { "source.fixAll.eslint": true }:保存即格式化 + 自动修复 ESLint 可修问题 -
"files.associations": { "*.tsx": "typescriptreact", "*.ts": "typescript" }:确保 TSX 文件正确识别为 React 类型 -
"emeraldwalk.runonsave": { "commands": [ { "match": "\\.tsx?$", "cmd": "eslint --fix ${file}" } ] }(可选):更细粒度控制保存时执行命令(需安装 Run On Save 插件)
推荐的 .vscode 文件夹配置
在项目根目录下建 .vscode/,放入两个文件,提升团队一致性:
感谢您选择使用ERMEB域名授权离线网络验证系统(简称:ERMEB域名授权系统)是ERMEB团队开发,ERMEB域名授权系统是国内最稳定,最强大,最先进的域名授权管理平台解决方案之一,ERMEB域名授权系统采用PHP +Mysql的技术,ERMEB域名授权系统框架使用Thinkphp6/mysql数据库基于Markdown开发者文档开发而成,项目安装请参考ThinkPHP官方文档及下面的服务环境说
-
settings.json:包含上述编辑器偏好,比如缩进、换行、是否显示空格等,避免“我这看着好好的”问题 -
extensions.json:声明推荐插件列表,新成员克隆项目后 VSCode 会弹出“推荐安装”提示{ "recommendations": ["esbenp.prettier-vscode", "dbaeumer.vscode-eslint", "bradlc.vscode-tailwindcss"] }
进阶但实用:按需开启
不是必须,但在中大型项目中明显提效:
- Tailwind CSS IntelliSense:如果项目用 Tailwind,它能实时提示 class 名、颜色、间距等
- Import Cost:在 import 行末显示包体积估算,对性能敏感项目很有用
- GitLens:查看某行代码是谁、什么时候、为什么改的,适合协作维护老项目
-
Debugger for Chrome / Edge:配合
launch.json配置,直接在 VSCode 里断点调试浏览器端逻辑(现代 Create React App 已原生支持,无需额外配置)
基本上就这些。不复杂但容易忽略的是:所有配置都要和项目里的 package.json 脚本、eslint 和 prettier 版本对齐。插件再好,规则不一致,反而增加困惑。









