跳至主要内容

入门

Create React App 是创建单页 React 应用程序的官方支持方式。它提供现代构建设置，无需配置。

快速入门​

npx create-react-app my-app
cd my-app
npm start

如果您之前已通过 npm install -g create-react-app 全局安装了 create-react-app，我们建议您使用 npm uninstall -g create-react-app 或 yarn global remove create-react-app 卸载该软件包，以确保 npx 始终使用最新版本。

(npx 与 npm 5.2+ 及更高版本捆绑在一起，请参阅 旧版 npm 版本的说明)

然后打开 https://127.0.0.1:3000/ 查看您的应用程序。

准备好部署到生产环境时，使用 npm run build 创建一个最小化的捆绑包。

npm start

立即开始​

您**不需要**安装或配置像 webpack 或 Babel 这样的工具。它们已预先配置并隐藏，以便您可以专注于代码。

创建一个项目，您就可以开始了。

创建应用程序​

您需要在本地开发机器上安装 Node >= 14（但在服务器上不需要）。您可以使用 nvm（macOS/Linux）或 nvm-windows 在不同项目之间切换 Node 版本。

要创建一个新的应用程序，您可以选择以下方法之一

npx​

npx create-react-app my-app

(npx 与 npm 5.2+ 及更高版本捆绑在一起，请参阅 旧版 npm 版本的说明)

npm​

npm init react-app my-app

npm init <initializer> 在 npm 6+ 中可用

Yarn​

yarn create react-app my-app

yarn create 在 Yarn 0.25+ 中可用

选择模板​

您现在可以选择从模板开始一个新的应用程序，方法是在创建命令中附加 --template [template-name]。

如果您没有选择模板，我们将使用我们的基本模板创建您的项目。

模板始终以 cra-template-[template-name] 的格式命名，但是您只需要在创建命令中提供 [template-name]。

npx create-react-app my-app --template [template-name]

您可以在 npm 上搜索 "cra-template-*" 来查找可用模板的列表。

我们的 自定义模板 文档描述了如何构建自己的模板。

创建 TypeScript 应用程序​

您可以使用模板启动一个新的 TypeScript 应用程序。要使用我们提供的 TypeScript 模板，请在创建命令中添加 --template typescript。

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

如果您已经有一个项目，并且想要添加 TypeScript，请参阅我们的 添加 TypeScript 文档。

选择包管理器​

当您创建一个新的应用程序时，CLI 将使用 npm 或 Yarn 来安装依赖项，具体取决于您用来运行 create-react-app 的工具。例如

# Run this to use npm
npx create-react-app my-app
# Or run this to use yarn
yarn create react-app my-app

输出​

运行任何这些命令将在当前文件夹中创建一个名为 my-app 的目录。在该目录中，它将生成初始项目结构并安装传递依赖项

my-app
├── README.md
├── node_modules
├── package.json
├── .gitignore
├── public
│   ├── favicon.ico
│   ├── index.html
│   ├── logo192.png
│   ├── logo512.png
│   ├── manifest.json
│   └── robots.txt
└── src
    ├── App.css
    ├── App.js
    ├── App.test.js
    ├── index.css
    ├── index.js
    ├── logo.svg
    ├── serviceWorker.js
    └── setupTests.js

没有配置或复杂的文件夹结构，只有构建应用程序所需的必要文件。安装完成后，您可以打开项目文件夹

cd my-app

脚本​

在新建的项目中，您可以运行一些内置的命令

npm start 或 yarn start​

在开发模式下运行应用程序。打开 https://127.0.0.1:3000 在浏览器中查看它。

如果您更改代码，页面将自动重新加载。您将在控制台中看到构建错误和 lint 警告。

Build errors

npm test 或 yarn test​

在交互模式下运行测试观察器。默认情况下，运行与自上次提交以来更改的文件相关的测试。

阅读有关测试的更多信息.

npm run build 或 yarn build​

将应用程序构建到生产环境，并将其放置到 build 文件夹中。它将正确地将 React 捆绑到生产模式，并优化构建以获得最佳性能。

构建结果将被压缩，并且文件名将包含哈希值。

您的应用程序已准备好部署。