vscode本身不提供react开发环境，真正起作用的是node.js、vite或create-react-app等构建工具、jsconfig.json/tsconfig.json配置及eslint等扩展协同；jsx报红需关闭javascript.validate.enable，调试须用pwa-chrome并配对webroot与sourcemappathoverrides，路径跳转失效则因缺失jsconfig.json。
VSCode 本身不提供 React 开发环境，它只负责编辑和调试；真正起作用的是 Node.js、构建工具（如 Vite 或 create-react-app）、项目配置文件，以及 VSCode 扩展之间的配合。装一堆插件但没配对底层，onClick 标红、useState 不提示、断点不生效，都是常态。
React 项目在 VSCode 里 JSX 报红？先关 javascript.validate.enable
VSCode 默认用内置 TypeScript 语言服务校验 JS/JSX，但它对纯 JS 的 React 项目支持极弱——useEffect、jsx 语法、甚至 className 都可能被标红，但代码实际能跑通。
- 打开设置（
Ctrl+,或Cmd+,），搜javascript.validate.enable，设为false - 确保已安装 ESLint 插件，并项目根目录有有效的
.eslintrc.js（推荐eslint-config-react-app） - 如果是 TypeScript 项目，必须有
tsconfig.json，且"jsx": "react-jsx"不能漏写，否则.tsx文件仍会报错
launch.json 调试不生效？别用 type: "chrome"，改用 pwa-chrome
VSCode 1.70+ 已弃用 type: "chrome"，继续用会直接报错：Unable to launch browser: "Can't find Chrome"，哪怕 Chrome 就装在电脑上。
已弃用 — 请改用 `auth0` 技能（运行 `npx clawhub install auth0`）。适用于为 React 单页应用（SPA）添加 Auth0 登录、登出、受保护路由或用户会话功能。该技能集成 `@auth0/auth0-react` — 即使用户仅表述为“为我的 React 应用添加登录功能”或“保护我的 React 路由”，而未明确提及 Auth0，也应使用此技能。
- 先手动运行
npm start（或yarn start），等看到Local: http://localhost:3000再调试 -
.vscode/launch.json中配置"type": "pwa-chrome"，"request": "attach"（不是launch） -
"url"必须和实际地址一致（CRA 是http://localhost:3000，Vite 常是http://localhost:5173） -
"webRoot"要指向源码目录："${workspaceFolder}/src"（不是/public或/dist） - Chrome 启动命令也要配对：Windows 运行
chrome.exe --remote-debugging-port=9222，macOS 运行open -a "Google Chrome" --args --remote-debugging-port=9222
跳转不到组件、路径补全失效？jsconfig.json 必须手建
没配 jsconfig.json，import Button from '@/components/Button' 就会标红，Ctrl+Click 也打不开文件——这不是插件问题，是路径解析没告诉编辑器“@”到底指哪。
- 项目根目录新建
jsconfig.json（TS 项目用tsconfig.json），内容至少含：{"compilerOptions": {"baseUrl": "src"}} - 如果用了路径别名（如
@/*），加"paths": {"@/*": ["src/*"]}，注意不是["@/*"]或["src/*"] - 改完必须完全退出 VSCode（不是重载窗口），否则缓存不刷新，跳转依然失败
- create-react-app 默认带
jsconfig.json，但常被误删；Vite 项目则完全不生成，必须手建
最易被忽略的一点：所有配置都依赖项目已正确初始化。没跑通 npx create-react-app my-app 或 npm create vite@latest my-app -- --template react，后续所有插件和配置都是空中楼阁。Node.js 版本不对、PATH 没配好、npm install 被跳过——这些底层卡点，比插件选错更致命。
