node.js 是 react 开发的必需底层环境，必须安装官方 lts 版本并正确配置 path；运行 node -v 和 npm -v 均需输出有效版本号，否则后续 npx、vite 初始化、import 解析、jsx 提示等全部失效。
Node.js 是 React 开发的底层依赖，不是“可选插件”，而是所有后续操作的前提。没装好 Node.js，npx、npm create vite、import 解析、JSX 语法高亮全都会失效——你看到的红波浪线，90% 不是代码错，是环境断了。
确认系统里有没有真正可用的 Node.js
别信“我以前装过”。很多 macOS 用户用系统自带 /usr/bin/node，Windows 用户用旧版或绿色版，这些几乎都踩坑：command not found: npx、permission denied、npm install 卡死。
- 去
nodejs.org下载 **LTS 版本**（不是 Current），安装时务必勾选Add to PATH - 终端运行
node -v和npm -v，必须同时输出有效版本号（如v20.11.1和10.2.4） - 如果输出
command not found或版本太老（v14及以下），说明 PATH 没生效，重启终端或重装
用 npm create vite@latest 初始化项目，别碰 create-react-app
React 官方文档自 2026 年 3 月起明确推荐 Vite。CRA 锁死 Webpack 配置，连 alias 都要绕路；Vite 的 vite.config.ts 是明文可改的，resolve.alias 两行就配好。
用于自动切换项目中适合的node 版本
下载
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
- 命令必须带双横线：
npm create vite@latest my-app -- --template react，漏掉--会导致模板识别失败 - 语言选
TypeScript，不是TypeScript + SWC（那是旧版残留项） - ESLint 选
Yes，它会自动装好eslint-plugin-react和eslint-plugin-react-hooks - 进目录后必须执行
npm install，跳过这步，VSCode 里所有 import 跳转、类型提示全失效
jsconfig.json 是 JSX 路径跳转和智能提示的开关
装了 Auto Import、Path Intellisense 却无法 Ctrl+Click 跳转组件？大概率是缺这个文件。VSCode 不会自动生成它，你得手动建。
- 在项目根目录新建
jsconfig.json，内容至少包含：{"compilerOptions": {"baseUrl": "src"}} - 没有它，
import Button from 'components/Button'会标红，且无法解析相对路径别名 - 如果用了
@/别名（比如import Header from '@/components/Header'），还得在jsconfig.json里加"paths"配置
VSCode 扩展只补能力，不兜底环境
装了 ESLint 插件但没报错？可能是因为项目没 .eslintrc.cjs；Prettier 格式化失灵？大概率是没设默认格式化工具为 esbenp.prettier-vscode。
- 必装扩展：ESLint、Prettier、ES7+ React/Redux/GraphQL/React-Native Snippets、Path Intellisense
- 关键设置要手动开：
"editor.formatOnSave": true、"editor.defaultFormatter": "esbenp.prettier-vscode" - 禁用 VSCode 自带的
TypeScript and JavaScript Language Features？千万别。它是语法校验和跳转的核心服务，关了就等于废了一半编辑器
最常被忽略的一点：Vite 默认端口是 5173，不是 3000。浏览器打不开？先看终端输出的 actual URL，别硬输 localhost:3000。
