Skip to content

create-react-app

create-react-app 是一个官方推荐的用于创建新的 React 单页应用程序的方式,它不需要配置构建工具。它提供了现代的构建设置,包含了热重载、ES6+ 语法支持、CSS 模块等功能,并且可以轻松地扩展以满足更复杂的需求。

以下是 create-react-app 的一些关键特性和使用方法:

React-cli 安装

React CLI 是一个用于创建 React 应用的命令行工具。要安装它,你需要先安装 Node.js 和 npm(Node 包管理器)。然后运行以下命令:

sh
npm install -g create-react-app

安装

要创建一个新的 React 应用程序,你可以全局安装 create-react-app CLI 工具(虽然这不是必需的),或者直接使用 npx 来运行它而无需安装。推荐的做法是使用 npx,因为它会在需要时自动下载最新的稳定版本。

bash
npx create-react-app my-app

这行命令将会创建一个名为 my-app 的新目录,并在其中初始化一个新的 React 应用程序。这个过程会安装所有必要的依赖项并设置好开发环境。

使用

进入项目文件夹后,你可以启动开发服务器:

bash
cd my-app
npm start

这将启动开发服务器,默认情况下监听本地的 3000 端口,并开启实时重载功能。你可以在浏览器中访问 http://localhost:3000 查看你的应用。

构建生产版本

当你准备好部署应用程序时,可以使用以下命令来构建优化后的生产版本:

bash
npm run build

这将在 build/ 文件夹下生成静态资源文件,这些文件可以直接上传到任何静态文件托管服务提供商处。

可选特性

create-react-app 提供了一些可选的特性,例如 TypeScript 支持、CSS 预处理器(Sass, Less)、实验性 JS 特性等。你可以通过传递参数给 create-react-app 命令来启用它们:

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

自定义配置

尽管 create-react-app 默认隐藏了 Webpack 和 Babel 等构建工具的具体配置,但如果你确实需要自定义配置,可以通过“弹出”(eject) 来揭示所有的配置文件。不过,请注意这是一个不可逆的操作,一旦执行了 eject,就不能再返回到默认的配置管理方式。

bash
npm run eject

其他命令

  • 测试npm test 启动测试运行器。
  • 清理缓存:如果遇到问题,可以尝试清除 node_modules 和缓存,然后重新安装依赖:
    bash
    rm -rf node_modules
    rm package-lock.json yarn.lock
    npm cache clean --force
    npm install

文档和资源

有关 create-react-app 更详细的信息,包括如何添加样式、路由、状态管理库等,请参阅官方文档:Create React App Documentation

Released under the MIT License.