react项目如何本地使用

本地运行React项目的步骤

确保已安装Node.js（建议版本14+）和npm/yarn。可通过以下命令检查版本：

node -v
npm -v

全局安装Create React App（CRA）脚手架工具（若需新建项目）：

npm install -g create-react-app

创建新项目：

npx create-react-app my-app
cd my-app

启动开发服务器：

npm start

默认情况下，项目会在浏览器自动打开 http://localhost:3000。

现有项目的本地运行

克隆项目代码后，安装依赖：

npm install

处理可能的依赖冲突：

npm audit fix

运行自定义脚本（参考项目package.json中的scripts字段）：

npm run dev  # 或其他自定义启动命令

环境配置

配置环境变量：

1. 创建.env文件在项目根目录
2. 定义变量（需以REACT_APP_开头）：

   REACT_APP_API_URL=http://localhost:4000

调试与构建

启用React开发者工具浏览器插件可辅助调试组件层级和状态。

生成生产环境构建：

npm run build

构建结果会输出到build目录，可通过serve等工具本地预览：

npx serve -s build

常见问题处理

端口冲突时修改启动端口：

PORT=3001 npm start

解决依赖版本冲突：

rm -rf node_modules package-lock.json
npm install