在 VS Code 中尝试

在 Visual Studio Code 中使用 React

React 是一个由 Facebook 开发的流行 JavaScript 库,用于构建用户界面。Visual Studio Code 编辑器开箱即用地支持 React.js 智能感知和代码导航。

Welcome to React

欢迎使用 React

在本教程中,我们将使用 create-react-app 生成器。要使用该生成器并运行 React 应用程序服务器,你需要安装 Node.js JavaScript 运行时和 npm(Node.js 包管理器)。npm 随 Node.js 一起提供,你可以从 Node.js 下载进行下载和安装。

提示:要测试你的机器上是否正确安装了 Node.js 和 npm,你可以在终端或命令提示符中输入 node --versionnpm --version

你现在可以通过键入以下命令创建一个新的 React 应用程序:

npx create-react-app my-app

其中 my-app 是你的应用程序文件夹的名称。创建 React 应用程序并安装其依赖项可能需要几分钟。

注意:如果你之前通过 npm install -g create-react-app 全局安装了 create-react-app,建议你使用 npm uninstall -g create-react-app 卸载该包,以确保 npx 始终使用最新版本。

让我们通过导航到新文件夹并键入 npm start 快速运行我们的 React 应用程序,以启动 Web 服务器并在浏览器中打开应用程序。

cd my-app
npm start

你应该在浏览器中看到 React 徽标和 http://localhost:3000 上指向“学习 React”的链接。在我们使用 VS Code 查看应用程序时,我们将保持 Web 服务器运行。

要在 VS Code 中打开你的 React 应用程序,请打开另一个终端或命令提示符窗口,导航到 my-app 文件夹并键入 code .

cd my-app
code .

Markdown 预览

在文件资源管理器中,你会看到一个应用程序的 README.md Markdown 文件。其中包含许多关于应用程序和 React 的有用信息。查看 README 的一个好方法是使用 VS Code Markdown 预览。你可以在当前编辑器组中打开预览(Markdown: Open Preview ⇧⌘V (Windows, Linux Ctrl+Shift+V)),也可以在侧边的新编辑器组中打开(Markdown: Open Preview to the Side ⌘K V (Windows, Linux Ctrl+K V))。你将获得精美的格式、指向标题的超链接导航以及代码块中的语法高亮。

README Markdown Preview

语法高亮和括号匹配

现在展开 src 文件夹并选择 index.js 文件。你会注意到 VS Code 为各种源代码元素提供了语法高亮显示,并且如果你将光标放在括号上,匹配的括号也会被选中。

React bracket matching

智能感知

当你开始在 index.js 中键入时,你会看到智能建议或完成。

React IntelliSense suggestions

选择建议并键入 . 后,你可以通过智能感知查看对象的类型和方法。

React IntelliSense

VS Code 使用 TypeScript 语言服务提供 JavaScript 代码智能,它具有一项称为自动类型获取 (ATA) 的功能。ATA 会为 package.json 中引用的 npm 模块下载 npm 类型声明文件 (*.d.ts)。

如果你选择一个方法,还会获得参数帮助。

React parameter help

转到定义,查看定义

通过 TypeScript 语言服务,VS Code 还可以在编辑器中通过转到定义 (F12) 或查看定义 (⌥F12 (Windows Alt+F12, Linux Ctrl+Shift+F10)) 提供类型定义信息。将光标放在 App 上,右键单击并选择查看定义。这将打开一个查看窗口,显示 App.jsApp 的定义。

React Peek definition

Escape 关闭查看窗口。

Hello World

让我们将示例应用程序更新为“Hello World!”。在 index.js 中创建一个名为 HelloWorld 的组件,其中包含一个带有“Hello, world!”的 H1 标题,并将 root.render 中的 <App /> 标记替换为 <HelloWorld />

import React from 'react';
import ReactDOM from 'react-dom/client';
import './index.css';
import App from './App';
import reportWebVitals from './reportWebVitals';

function HelloWorld() {
  return <h1 className="greeting">Hello, world!</h1>;
}

const root = ReactDOM.createRoot(document.getElementById('root'));
root.render(
  <React.StrictMode>
    <HelloWorld />
  </React.StrictMode>
);

// If you want to start measuring performance in your app, pass a function
// to log results (for example: reportWebVitals(console.log))
// or send to an analytics endpoint. Learn more: https://bit.ly/CRA-vitals
reportWebVitals();

保存 index.js 文件后,正在运行的服务器实例将更新网页,刷新浏览器时会看到“Hello World!”。

提示:VS Code 支持自动保存,默认情况下会在延迟后保存文件。检查文件菜单中的自动保存选项以启用自动保存,或直接配置 files.autoSave 用户设置

Hello, world

调试 React

要调试客户端 React 代码,我们将使用内置的 JavaScript 调试器。

注意:本教程假定你已安装 Edge 浏览器。如果你想使用 Chrome 进行调试,请将启动配置中的 type 替换为 chrome。还有一个用于 Firefox 浏览器的调试器。

设置断点

要在 index.js 中设置断点,请单击行号左侧的装订线。这将设置一个断点,断点将显示为一个红色圆圈。

Set a breakpoint

配置调试器

我们需要先配置调试器。为此,请转到运行和调试视图 (⇧⌘D (Windows, Linux Ctrl+Shift+D)),然后选择创建 launch.json 文件链接以创建 launch.json 调试器配置文件。从选择调试器下拉列表中选择 Web App (Edge)。这将在你的项目中创建一个新的 .vscode 文件夹,并在其中生成一个包含用于启动网站配置的 launch.json 文件。

我们需要为我们的示例进行一项更改:将 url 的端口从 8080 更改为 3000。你的 launch.json 应如下所示:

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "msedge",
      "request": "launch",
      "name": "Launch Edge against localhost",
      "url": "http://localhost:3000",
      "webRoot": "${workspaceFolder}"
    }
  ]
}

确保你的开发服务器正在运行 (npm start)。然后按 F5 或绿色箭头启动调试器并打开一个新的浏览器实例。设置断点的源代码在调试器附加之前已在启动时运行,因此只有在刷新网页后才能命中断点。刷新页面,你应该会命中断点。

Debugger hitting breakpoint

你可以单步调试源代码 (F10),检查诸如 HelloWorld 之类的变量,并查看客户端 React 应用程序的调用堆栈。

Debug element variable

有关调试器及其可用选项的更多信息,请查看我们的浏览器调试文档。

实时编辑和调试

如果你在 React 应用程序中使用了 webpack,则可以利用 webpack 的 HMR 机制,从而实现更高效的工作流,你可以直接从 VS Code 中进行实时编辑和调试。你可以在这篇直接从 VS Code 实时编辑和调试你的 React 应用程序博客文章和 webpack 热模块替换文档中了解更多信息。

代码检查

Lint 工具会分析你的源代码,并在你运行应用程序之前警告你潜在的问题。VS Code 中包含的 JavaScript 语言服务默认支持语法错误检查,你可以在问题面板(查看 > 问题 ⇧⌘M (Windows, Linux Ctrl+Shift+M)) 中看到它的作用。

尝试在你的 React 源代码中制造一个小错误,你会在编辑器中看到一条红色波浪线,并在问题面板中看到一个错误条目。

JavaScript error

Lint 工具可以提供更复杂的分析,强制执行编码约定并检测反模式。流行的 JavaScript lint 工具是 ESLint。ESLint 与 ESLint VS Code 扩展结合使用,可以提供出色的产品内 linting 体验。

首先,安装 ESLint 命令行工具:

npm install -g eslint

然后,通过转到扩展视图并键入 'eslint' 来安装 ESLint 扩展。

ESLint extension

安装 ESLint 扩展并重新加载 VS Code 后,你需要创建一个 ESLint 配置文件 .eslintrc.js。你可以从命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 使用扩展提供的 ESLint: Create ESLint configuration 命令来创建一个。

Find the configuration command

该命令将提示你在终端面板中回答一系列问题。接受默认值,它将在你的项目根目录中创建一个 .eslintrc.js 文件,看起来像这样:

module.exports = {
  env: {
    browser: true,
    es2020: true
  },
  extends: ['eslint:recommended', 'plugin:react/recommended'],
  parserOptions: {
    ecmaFeatures: {
      jsx: true
    },
    ecmaVersion: 11,
    sourceType: 'module'
  },
  plugins: ['react'],
  rules: {}
};

ESLint 现在将分析打开的文件,并在 index.js 中显示关于“App”已定义但从未使用的警告。

App is unused

你可以修改 .eslintrc.js 文件中的 ESLint 规则

让我们为多余的分号添加一个错误规则:

 "rules": {
        "no-extra-semi":"error"
    }

现在,当你在同一行意外地有多个分号时,你会在编辑器中看到一个错误(红色波浪线),并在问题面板中看到错误条目。

Extra semicolon error

在本教程中,我们使用 create-react-app 生成器创建了一个简单的 React 应用程序。有很多很棒的示例和入门套件可帮助你构建第一个 React 应用程序。

VS Code React 示例

这是一个 示例 React 应用程序,它创建了一个简单的 TODO 应用程序,并包含 Node.js Express 服务器的源代码。它还展示了如何使用 Babel ES6 转译器,然后使用 webpack 打包网站资源。

TypeScript React

如果你对 TypeScript 和 React 感兴趣,你还可以通过指定要使用 TypeScript 模板来创建 create-react-app 应用程序的 TypeScript 版本:

npx create-react-app my-app --template typescript

详情请参阅 Create React App 网站上的 添加 TypeScript

Angular

Angular 是另一个流行的 Web 框架。如果你想查看 Angular 与 VS Code 配合使用的示例,请查阅使用 Angular CLI 调试秘籍。它将引导你创建 Angular 应用程序并为 JavaScript 调试器配置 launch.json 文件。

常见问题

我可以在声明式 JSX 中获得智能感知吗?

是的。例如,如果你打开 create-react-app 项目的 App.js 文件,可以在 render() 方法中看到 React JSX 中的智能感知。

JSX IntelliSense