Skip to content

开发环境搭建 ​

在开始学习 React 之前,我们需要搭建好开发环境。本章节将指导你完成开发工具的安装和配置。

3.1 开发工具安装 ​

VS Code 安装 ​

  1. 下载 VS Code:

    • 访问 VS Code 官网
    • 选择适合你操作系统的版本下载
    • 按照安装向导完成安装
  2. VS Code 必备插件:

    • ESLint:代码质量检查
    • Prettier:代码格式化
    • React Developer Tools:React 调试工具
    • Vetur:Vue 支持(如果需要)
    • GitLens:Git 增强
    • Live Server:本地开发服务器
  3. 安装插件方法:

    • 打开 VS Code
    • 点击左侧的扩展图标(四个方块)
    • 在搜索框中输入插件名称
    • 点击「安装」按钮

React Developer Tools ​

  1. 浏览器扩展:

  2. 使用方法:

    • 打开包含 React 应用的网页
    • 打开浏览器开发者工具
    • 选择「React」标签页
    • 可以查看组件树、状态和 props

3.2 环境配置 ​

Node.js 安装 ​

  1. 下载 Node.js:

    • 访问 Node.js 官网
    • 下载 LTS(长期支持)版本
    • 按照安装向导完成安装
  2. 验证安装:

    • 打开命令行终端
    • 运行 node -v 查看 Node.js 版本
    • 运行 npm -v 查看 npm 版本

npm/pnpm/yarn 配置 ​

npm(默认包管理器) ​

  • 更新 npm:npm install -g npm
  • 设置镜像(可选):npm config set registry https://registry.npmmirror.com/

pnpm(推荐,更快速) ​

  • 安装 pnpm:npm install -g pnpm
  • 设置镜像(可选):pnpm config set registry https://registry.npmmirror.com/

yarn(备选) ​

  • 安装 yarn:npm install -g yarn
  • 设置镜像(可选):yarn config set registry https://registry.npmmirror.com/

3.3 浏览器调试工具 ​

Chrome 开发者工具 ​

  1. 打开开发者工具:

    • 快捷键:F12 或 Ctrl+Shift+I
    • 右键点击页面,选择「检查」
  2. 常用面板:

    • Elements:查看和修改 DOM 结构
    • Console:查看控制台输出和执行 JavaScript
    • Sources:查看和调试 JavaScript 代码
    • Network:查看网络请求
    • Application:查看 localStorage、sessionStorage 等
    • React:(安装 React Developer Tools 后)查看 React 组件

Firefox 开发者工具 ​

  1. 打开开发者工具:

    • 快捷键:F12 或 Ctrl+Shift+I
    • 右键点击页面,选择「检查元素」
  2. 常用面板:

    • Inspector:查看和修改 DOM 结构
    • Console:查看控制台输出和执行 JavaScript
    • Debugger:查看和调试 JavaScript 代码
    • Network:查看网络请求
    • Storage:查看 localStorage、sessionStorage 等
    • React:(安装 React Developer Tools 后)查看 React 组件

3.4 第一个React程序 ​

在线编辑器体验 ​

  1. CodeSandbox:

    • 访问 CodeSandbox
    • 点击「Create Sandbox」
    • 选择「React」模板
    • 等待项目创建完成
  2. 基本结构:

    • src/App.js:主组件
    • src/index.js:入口文件
    • public/index.html:HTML 模板
  3. 修改代码:

    • 在 App.js 中修改内容
    • 实时查看效果

本地创建项目 ​

  1. 使用 Vite 创建项目(推荐):

    • 打开命令行终端
    • 运行 npm create vite@latest my-react-app -- --template react
    • 进入项目目录:cd my-react-app
    • 安装依赖:npm install
    • 启动开发服务器:npm run dev
  2. 使用 create-react-app:

    • 打开命令行终端
    • 运行 npx create-react-app my-react-app
    • 进入项目目录:cd my-react-app
    • 启动开发服务器:npm start
  3. 查看项目:

    • 打开浏览器,访问终端中显示的地址(通常是 http://localhost:3000/ 或 http://localhost:5173/)
    • 你应该能看到 React 的默认欢迎页面

常见问题解决 ​

  1. Node.js 安装失败:

    • 确保下载了正确的版本
    • 以管理员身份运行安装程序
    • 检查系统环境变量
  2. npm 安装依赖失败:

    • 检查网络连接
    • 尝试使用镜像源
    • 清理 npm 缓存:npm cache clean --force
  3. 开发服务器启动失败:

    • 检查端口是否被占用
    • 确保依赖已正确安装
    • 查看终端错误信息
  4. React Developer Tools 不显示:

    • 确保页面使用了 React
    • 刷新页面
    • 重新安装扩展

通过本章节的学习,你已经完成了 React 开发环境的搭建,为后续的学习做好了准备。现在你可以开始学习 React 的核心概念和实践技能了。

© 2026 编程马·菜鸟教程 版权所有