第3章 开发工具配置

Chapter-03 - 开发工具配置

3.1 VS Code 下载与安装

工欲善其事,必先利其器。作为 React 开发者,我们的"器"就是代码编辑器。目前市面上最流行的前端代码编辑器,当属 Visual Studio Code(简称 VS Code)——它免费、开源、轻量、功能强大,而且是微软出品,质量有保证(这次真的是微软出品,不像某些别的产品……)。

3.1.1 官网下载与安装

去 VS Code 官网 code.visualstudio.com,你会看到一个巨大的"Download for Windows"按钮,点击它就开始下载了。

安装步骤(Windows 用户):

  1. 双击下载好的 .exe 安装包
  2. 勾选"我同意此协议",点击"下一步"
  3. 选择安装位置(默认 C 盘就行,不用改)
  4. 重要:在"选择其他任务"这一步,记得勾选:
    • ✅ “将 Code 添加到 PATH”(这样你可以在命令行里直接用 code 打开文件)
    • ✅ “创建桌面快捷方式”
  5. 一路"下一步",最后点"完成"

安装步骤(macOS 用户):

  1. 下载 .zip
  2. 解压,把"Visual Studio Code.app"拖到应用程序文件夹里
  3. 第一次打开时,会提示"是否要打开从互联网下载的应用",点"打开"

💡 小技巧:安装完成后,按 Ctrl + Shift + P(macOS 是 Command + Shift + P),输入 “shell”,选择"安装 ‘code’ 命令到 PATH",这样你就可以在终端里用 code . 命令直接用 VS Code 打开当前文件夹了!超级方便!

3.1.2 便携版(Portable)安装

VS Code 还有一个便携版(Portable),它的特点是:

  • 不需要安装,直接解压就能用
  • 所有配置都存在 VS Code 的文件夹里,不污染系统
  • 适合放在 U 盘里随身携带,或者在多台电脑间同步

下载便携版:

code.visualstudio.com 下载页面,找到"User Installer"或"Portable"版本(Windows 用户找 .zip 格式的包)。

使用方法:

  1. 解压到一个文件夹,比如 D:\Tools\VSCode\
  2. 第一次运行,会在同级目录创建一个 data 文件夹存放配置
  3. 之后所有的设置、插件都会存在这个 data 文件夹里

便携版的适用场景:你的公司电脑不允许安装软件?用 U 盘装一个便携版!你在家和工作电脑之间想同步配置?把整个 VS Code 文件夹同步到云盘就行!


3.2 必装插件清单

VS Code 本身已经很强大了,但有了插件,它才能真正成为前端开发的"神器"。以下是 React 开发者的必备插件清单,强烈建议全部安装!

3.2.1 ES7+ React/Redux/React-Native snippets:快速生成代码片段

这个插件堪称"代码生成器",输入几个字母,自动补全整段代码。

常用代码片段:

1
2
3
4
5
6
7
# 输入以下简写,按 Tab 键,自动生成代码!
rfc         -> React 函数组件(最常用!)
rcc         -> React Class 组件(Class 组件写法)
rsc         -> React 箭头函数组件
useState    -> React Hook: useState
useEffect   -> React Hook: useEffect
useRef      -> React Hook: useRef

小贴士:rfc 是最最常用的!每次新建组件,rfc + Tab,一秒出代码骨架,效率拉满!

生成的示例(输入 rfc 后按 Tab):

1
2
3
4
5
6
7
8
9
import React from 'react';

export default function MyComponent() {
  return (
    <div>
      <h1>MyComponent</h1>
    </div>
  );
}

3.2.2 Prettier - Code formatter:代码格式化

代码格式化工具,帮你自动整理代码格式——缩进、空格、换行……一键搞定,从此告别"代码风格不统一"的世纪难题。

使用方法:

  1. 安装插件后,设置 VS Code 的默认格式化工具为 Prettier
  2. Shift + Alt + F(Windows)或 Shift + Option + F(macOS)自动格式化当前文件
  3. 设置保存时自动格式化:在 settings.json 里加上 "editor.formatOnSave": true

Prettier 的核心理念:格式化规则是固定的,没有配置项给你调。 它故意这么设计——减少团队内部的格式争议,大家用同一套规则,自动格式化,代码风格永远一致。

3.2.3 Auto Rename Tag:自动重命名配对标签

写 HTML/JSX 的时候,改一个标签的名字,另一个标签不会自动改?Auto Rename Tag 帮你解决这个痛点!

场景演示:

1
2
// 你想把 <div className="container"> 改成 <main className="container">
// 只需要改开始标签 <div> -> <main>,结束标签 </div> 会自动变成 </main>

不装这个插件的话,你得手动改两个地方,改着改着就漏掉一个,然后代码就报错了……别问我怎么知道的。😭

3.2.4 ESLint:代码检查

ESLint 是 JavaScript 的"代码警察",它会扫描你的代码,找出潜在的问题和不规范的写法。

ESLint 能帮你发现的问题:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
// 1. 未使用的变量
const unused = '我是没用的变量';  // ESLint 会警告:unused 变量
console.log('Hello');

// 2. 缩进不规范
function bad() {
 console.log('缩进错误');  // ESLint 会要求统一用 2 空格缩进
}

// 3. 危险的 == 用法
if (value == 1) { }  // ESLint 建议用 === 替代 ==

安装 ESLint 插件后,还需要安装 eslint 包:

1
2
npm install -D eslint
npx eslint --init  # 初始化 ESLint 配置,生成 .eslintrc.cjs 文件

3.2.5 Error Lens:错误即时显示

这个插件把 ESLint 的警告和错误直接"怼"到代码行的末尾,红色波浪线 + 错误信息实时显示,让你一眼就看到问题在哪里。

效果:

1
2
3
// 这行代码有问题,Error Lens 会在这行末尾直接显示:
// Expected '===' and instead saw '=='.eslint(eqeqeq)
if (value == 1) { }

3.2.6 GitLens:Git 增强工具

GitLens 是 Git 的"超级增强版",它让你在 VS Code 里看到每一行代码的 Git 历史——谁写的、什么时候改的、改了些什么,一目了然。

超级实用的功能:

  1. 行级 Blame:把鼠标放到某一行代码上,就能看到这行代码的提交信息和作者
  2. 提交历史可视化:点击"历史"按钮,查看整个文件的修改时间线
  3. Compare 视图:对比两个提交之间的差异

3.2.7 Simple React Snippets:React 代码片段

另一个 React 代码片段插件,与 ES7+ Snippets 互补,专门针对 React 的常用写法做了优化。

常用片段:

1
2
3
4
5
imr     -> import React from 'react'           # React 导入语句
imrn    -> import React, { useState } from 'react'  # React + Hooks 导入
ffc     -> React 箭头函数组件(无状态)
usf     -> useState 的完整写法
udf     -> useEffect 的完整写法

3.3 界面与快捷键优化

VS Code 的强大,有一半来自于快捷键。学会快捷键,效率提升 300%!

3.3.1 常用快捷键:Ctrl+P、Ctrl+Shift+P、Ctrl+`、Ctrl+B

以下是日常开发中最最最常用的快捷键,请务必熟记:

文件操作:

1
2
3
4
Ctrl + P        # 快速打开文件(输入文件名,不用记完整路径)
Ctrl + Tab     # 切换到上一个打开的文件
Ctrl + W        # 关闭当前文件
Ctrl + K + S   # 打开快捷键设置(查看所有快捷键)

命令行面板(Command Palette):

1
2
3
4
5
Ctrl + Shift + P   # 打开命令行面板,输入命令名称执行
# 常用命令示例:
# "Format Document"      -> 格式化当前文件
# "Toggle Terminal"       -> 显示/隐藏终端
# "Git: Pull"            -> 执行 Git Pull

终端操作:

1
2
Ctrl + `        # 显示/隐藏内置终端(` 是 Tab 键上面的那个反引号)
Ctrl + Shift + ` # 新建一个终端窗口

侧边栏:

1
2
3
4
5
Ctrl + B        # 显示/隐藏左侧资源管理器(Explorer)
Ctrl + Shift + E  # 聚焦资源管理器
Ctrl + Shift + G  # 打开 Git 源代码管理面板
Ctrl + Shift + X  # 打开扩展(Extensions)面板
Ctrl + Shift + F   # 全局搜索(Search)面板

编辑器操作:

1
2
3
4
5
6
Ctrl + /        # 注释/取消注释当前行(或者选中的多行)
Alt + ↑ / ↓     # 将当前行向上/向下移动
Shift + Alt + ↑ / ↓  # 向上/向下复制当前行
Ctrl + D        # 选中下一个相同的内容(多光标编辑必备)
Alt + 单击       # 在多处创建光标(多光标编辑)
Ctrl + Shift + L  # 选中所有相同的内容

🎯 高手秘籍:多光标编辑是 VS Code 最强大的功能之一!比如你有 10 个地方都要改成同一个变量名,只需要:Ctrl + D 连续按 10 次选中所有相同内容,然后输入新的变量名,所有光标处同时被修改!

3.3.2 代码片段(Snippets)自定义

VS Code 支持自定义代码片段,你可以创建自己的快捷补全!

创建一个自定义 Snippet:

  1. Ctrl + Shift + P,输入 “snippets”,选择"配置用户代码片段"
  2. 选择"新建全局代码片段文件"
  3. 输入文件名,比如 “my-react-snippets”
  4. VS Code 会打开一个 .code-snippets 文件
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
  "React Functional Component with PropTypes": {
    "prefix": "rfcp",           // 触发词,输入 rfcp 按 Tab
    "body": [
      "import React from 'react';",
      "import PropTypes from 'prop-types';",
      "",
      "function ${1:MyComponent}({ $2 }) {",
      "  return (",
      "    <div className=\"${TM_FILENAME_BASE}\">",
      "      $3",
      "    </div>",
      "  );",
      "}",
      "",
      "${1:MyComponent}.propTypes = {",
      "  $2: PropTypes.",
      "};",
      "",
      "export default ${1:MyComponent};"
    ],
    "description": "React 函数组件 + PropTypes"
  }
}

3.3.3 Settings Sync:配置云同步

如果你在多台电脑上开发,或者重装了系统,VS Code 的设置和插件就会丢失。Settings Sync 插件可以把你所有的配置、插件、快捷键设置同步到 GitHub Gist 上,换电脑也能一键恢复!

使用方法:

  1. 在 VS Code 扩展市场搜索"Settings Sync",安装
  2. Shift + Alt + U 上传配置到 GitHub Gist
  3. 在新电脑上安装 Settings Sync,按 Shift + Alt + D 下载配置

💡 小技巧:VS Code 从 1.75 版本开始内置了 Settings Sync 功能,不再需要额外插件!路径:设置 → 打开 Settings Sync


3.4 调试配置

调试(Debug)是开发过程中非常重要的一环。当你的代码出现 bug 时,学会用调试器定位问题,比用 console.log 一行行打印要高效一万倍!

3.4.1 launch.json 配置:调试 React 代码

VS Code 内置了调试功能,配置好 launch.json 后,你就可以直接在 VS Code 里打断点、逐行执行、查看变量值——就像 IDE 一样专业!

步骤一:创建 launch.json 文件

  1. 点击 VS Code 左侧的"运行和调试"按钮(虫子图标 🐛)
  2. 点击"创建一个 launch.json 文件"
  3. 选择"Chrome"(或你要调试的浏览器)
  4. VS Code 会自动生成 .vscode/launch.json 文件

步骤二:配置 launch.json

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Launch Chrome",           // 配置名称
      "type": "chrome",                 // 调试器类型
      "request": "launch",              // launch=启动新浏览器,attach=附加到已有浏览器
      "url": "http://localhost:5173",   // 你的开发服务器地址
      "webRoot": "${workspaceFolder}",  // 项目根目录
      "sourceMaps": true,               // 启用 Source Map(方便调试压缩后的代码)
      "preLaunchTask": "npm: dev"       // 调试前先运行 dev 任务(启动开发服务器)
    },
    {
      "name": "Attach to Chrome",        // 附加到已打开的浏览器
      "type": "chrome",
      "request": "attach",
      "url": "http://localhost:5173",
      "port": 9222,                     // Chrome 调试端口
      "webRoot": "${workspaceFolder}"
    }
  ]
}

步骤三:设置 preLaunchTask(可选)

如果你想让 VS Code 在调试前自动启动开发服务器,需要在 tasks.json 里定义任务:

  1. Ctrl + Shift + P,输入 “tasks: Configure Task”
  2. 选择"使用模板创建 tasks.json 文件"
  3. 选择"npm"
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "npm: dev",       // 这个名字要和 launch.json 里的 preLaunchTask 对应
      "type": "npm",
      "script": "dev",
      "isBackground": true,      // 后台运行,不阻塞调试过程
                               // 设置为 true 时,VS Code 不会等任务"结束"(因为 dev 服务器永远不停止)
                               // 而是让它在后台运行,这样开发服务器和调试器可以同时工作
      "problemMatcher": {
        "owner": "custom",
        "pattern": {
          "regexp": "^$"          // 匹配空行(后台任务不需要匹配错误)
                                   // "^$" 匹配空字符串,意味着永远不匹配任何内容
                                   // 这样即使服务器持续输出日志,VS Code 也不会误认为是错误
        },
        "activeForm": "starting dev server..."
      },
      "group": {
        "kind": "build",
        "isDefault": true
      }
    }
  ]
}

调试技巧:

1
2
3
4
5
6
7
8
// 1. 在代码行号左侧点击,添加断点(红色圆点)
function calculateTotal(items) {
  const total = items.reduce((sum, item) => {
    debugger;  // 2. 或者直接在代码里写 debugger,程序会在这一行暂停
    return sum + item.price;
  }, 0);
  return total;
}

调试模式下,你可以:

  • F5:开始调试
  • F10:单步跳过(不进入函数内部)
  • F11:单步进入(进入调用的函数内部)
  • Shift + F5:停止调试
  • Watch 窗口:添加表达式,实时观察变量值

3.4.2 React DevTools 浏览器插件安装与使用

React DevTools 是 Facebook 官方出品的浏览器调试插件,它让你能在浏览器的开发者工具里直接查看 React 组件的树状结构、props、state,是 React 开发者的"透视眼"!

安装:

安装后如何使用:

  1. 用 Vite 或 Create React App 启动你的 React 项目
  2. 在浏览器里打开你的页面
  3. F12 打开开发者工具
  4. 你会看到两个新标签页:
    • Components:组件树,查看每个组件的 props、state、refs
    • Profiler:性能分析器,记录组件渲染次数和渲染耗时

Components 标签页的常用操作:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
// 假设有这样一个组件树
<App>
  <Navbar>
    <Logo />
    <Menu items={[...]} />
  </Navbar>
  <Main>
    <UserCard user={{ name: '张三', age: 25 }} />
    <PostList posts={[...]} />
  </Main>
</App>

// 在 React DevTools Components 面板里:
// 1. 点击 <UserCard> 组件,右侧面板显示 props: { user: { name: '张三', age: 25 } }
// 2. 点击 state 字段,可以实时修改 state 值(会实时反映到页面上!)
// 3. 点击 "Highlight updates" 按钮,渲染的组件会闪烁高亮,方便你找出不必要的重渲染

🔥 Profiler 标签页超级有用!它能帮你找出哪些组件渲染次数太多、哪些渲染太慢,是优化 React 应用性能的必备工具!后面的章节会详细介绍 Profiler 的使用方法。


本章小结

本章我们为 React 开发配置好了"武器库":

  • VS Code:免费、强大、插件丰富的代码编辑器,是 React 开发的首选 IDE
  • 必备插件:ES7+ Snippets(代码补全)、Prettier(格式化)、Auto Rename Tag(自动补标签)、ESLint(代码检查)、Error Lens(错误即时显示)、GitLens(Git 历史)、Simple React Snippets(React 片段)
  • 快捷键:熟记 Ctrl + P(快速打开文件)、Ctrl + Shift + P(命令面板)、Ctrl + B(侧边栏)、Ctrl + D(多光标选择)等常用快捷键
  • 调试配置launch.json + React DevTools,让你能像专业 IDE 一样打断点调试 React 代码

下一章,我们将动手创建第一个 React 项目——使用 Vite + React 19!从零开始,一步一步搭起来!🚀