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(默认包管理器)

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

pnpm(推荐,更快速)

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

yarn(备选)

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

3.3 浏览器调试工具

Chrome 开发者工具

  1. 打开开发者工具

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

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

Firefox 开发者工具

  1. 打开开发者工具

    • 快捷键:F12Ctrl+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 编程马·菜鸟教程 版权所有