VSCode需通过扩展和配置适配React开发：必装ES7+ React snippets、ESLint、Auto Rename Tag；jsconfig.json/tsconfig.json不可删且须正确配置路径别名和jsx选项；调试需配launch.json，HMR问题常因ESLint自动修复干扰。
VSCode 本身不“支持 React”，它靠扩展和配置来适配 React 开发流程。核心是装对扩展、配好 TypeScript/ESLint、启动时用对脚手架——不是 VSCode 决定你能不能写 React，而是你有没有让它的工具链对上 create-react-app 或 vite 的约定。
必须装的三个扩展
没它们，连基础高亮和跳转都卡顿：
-
ES7+ React/Redux/React-Native snippets：补全rfc（函数组件）、useEffect等常用代码块 -
ESLint：实时标出React Hook rules错误，比如React Hook "useState" is called in function "xxx" which is not a React function component -
Auto Rename Tag：改<div>开头，自动同步闭合标签，避免手动修</div>出错
tsconfig.json 和 jsconfig.json 别乱删
很多新手在 create-react-app 项目里看到 jsconfig.json 就删掉，结果路径别名（如 @/components）失效、Go to Definition 跳转失败。这个文件是 VSCode 识别模块解析规则的关键：
{
"compilerOptions": {
"baseUrl": "src",
"paths": {
"@/*": ["*"],
"@/components/*": ["components/*"]
}
},
"include": ["src/**/*"]
}
如果你用的是 TypeScript 项目，对应的是 tsconfig.json，同样不能删，且要确保 "jsx": "react-jsx" 存在，否则 JSX 语法会报红。
立即学习“前端免费学习笔记（深入）”；
调试 React 组件时断点不生效？检查 launch.json
VSCode 默认不带浏览器调试器，必须手动配 .vscode/launch.json。常见错误是用了旧版 type: "chrome" 却没装 Chrome 扩展，或端口冲突：
- 推荐用
type: "pwa-chrome"（新版 Debugger for Edge / Chrome） -
url必须和你npm start启的服务地址一致，通常是"http://localhost:3000" - 加
"webRoot": "${workspaceFolder}/src"，否则断点打在src/App.tsx会找不到源码映射
{
"version": "0.2.0",
"configurations": [
{
"type": "pwa-chrome",
"request": "launch",
"name": "Launch Chrome against localhost",
"url": "http://localhost:3000",
"webRoot": "${workspaceFolder}/src"
}
]
}
热更新（HMR）卡住或不刷新？优先关掉 ESLint 的保存自动修复
ESLint 扩展默认开启 "eslint.autoFixOnSave": true，但 React 项目中它可能在保存瞬间重写文件，干扰 Webpack/Vite 的 HMR 监听逻辑，表现为改了组件状态、页面却不动。解决方法：
- 关掉全局 autoFix，只在需要时按
Ctrl+Shift+P→ESLint: Fix all auto-fixable Problems - 或者在
.eslintrc.js里禁用易冲突规则："react-hooks/exhaustive-deps": "off"（仅开发期，上线前务必打开） - 确认
package.json中start脚本用的是react-scripts start或vite，而不是webpack serve手动配置——后者需额外配hot: true
React 开发里最常被忽略的其实是环境一致性：VSCode 的 typescript.version 是否和项目 node_modules/typescript 一致、ESLint 插件是否读的是项目根目录下的 .eslintrc.cjs 而不是用户全局配置——这些细节不调好，再全的扩展列表也救不了红波浪线和跳转失败。
