Create React App 中文文档

Create React App 中文文档

  • 快速入门
  • 帮助
  • GitHub

›高级用法

Welcome

  • 关于文档

快速入门

  • 入门
  • 文件夹结构
  • 可用的 Scripts
  • 支持的浏览器和特性
  • 更新到新版本

开发

  • 编辑器设置
  • 隔离开发组件
  • 分析 Bundle (包) 大小
  • 在开发环境中使用 HTTPS

样式和资源

  • 添加一个样式表
  • 添加 CSS Modules
  • 添加 Sass
  • PostCSS(后处理 CSS)
  • 添加图片,字体和文件
  • 使用 public 文件夹
  • 代码拆分(Code Splitting)

构建 App

  • 安装依赖项
  • 导入组件
  • 使用全局变量
  • 添加 Bootstrap
  • 添加 Flow
  • 添加 TypeScript
  • 添加 Relay
  • 添加 Router(路由)
  • 环境变量
  • 制作渐进式 Web 应用程序(PWA)
  • 创建生产构建

测试

  • 运行测试
  • 调试测试

后端集成

  • 在开发环境中代理 API 请求
  • 使用AJAX请求获取数据
  • 集成后端 API
  • Title & Meta 标签

部署

  • 部署

高级用法

  • 我可以使用 Decorators 吗?
  • 预渲染静态 HTML
  • 高级配置
  • Ejecting 的替代方案

支持

  • 故障排除
Edit

高级配置

你可以通过在 shell 中设置环境变量或使用 .env 来调整各种开发和生产设置。

变量DevelopmentProduction用法
BROWSER✅ Used🚫 Ignored默认情况下,Create React App 将打开默认系统浏览器,支持 macOS 上的 Chrome 。 指定 browser 以覆盖此行为,或将其设置为 none 以完全禁用它。 如果需要自定义启动浏览器的方式,则可以指定一个 node 脚本。 传递给 npm start 的任何参数也将传递给此脚本,并且提供应用程序的 url 将是最后一个参数。 你的脚本的文件名必须以 .js 为扩展名。
HOST✅ Used🚫 Ignored默认情况下,开发Web服务器绑定到 localhost 。你可以使用此变量指定其他主机。
PORT✅ Used🚫 Ignored默认情况下,开发 Web 服务器将尝试侦听端口 3000 或提示你尝试下一个可用端口。你可以使用此变量指定其他端口。
HTTPS✅ Used🚫 Ignored设置为 true 时,Create React App 将以 https 模式运行开发服务器。
PUBLIC_URL🚫 Ignored✅ UsedCreate React App 假定你的应用程序托管在服务 Web 服务器的根目录或 package.json (homepage) 中指定的子路径。 通常,Create React App 会忽略主机名。 你可以使用此变量强制资源逐字引用到你提供的 URL(hostname included.md)。 当使用 CDN 托管你的应用程序时,这可能特别有用。
CI✅ Used✅ Used设置为 true 时,Create React App 会将警告视为构建中的失败。这也使得 测试运行 不能检测到。大多数 CI 默认设置此标志。
REACT_EDITOR✅ Used🚫 Ignored当应用程序在开发过程中崩溃时,你将看到带有可点击堆栈跟踪的错误覆盖。 当你单击它时,Create React App 将尝试根据当前正在运行的进程确定你正在使用的编辑器,并打开相关的源文件。 你可以 发送拉取请求以检测你选择的编辑器。 设置此环境变量会覆盖自动检测。 如果这样做,请确保你的系统 PATH 环境变量指向编辑器的bin文件夹。 你也可以将其设置为 none 以完全禁用它。
CHOKIDAR_USEPOLLING✅ Used🚫 Ignored设置为 true 时,watcher 在 VM 内部根据需要以轮询模式运行。如果 npm start 未检测到更改,请使用此选项。
GENERATE_SOURCEMAP🚫 Ignored✅ Used设置为 false 时,不会为生产构建生成源映射。这解决了一些小型机器上的OOM问题。
NODE_PATH✅ Used✅ Used与 Node.js 中的 NODE_PATH 相同,但只允许相关文件夹。通过设置 NODE_PATH=src可以方便地模拟 monorepo 设置。
INLINE_RUNTIME_CHUNK🚫 Ignored✅ Used默认情况下,Create React App会在生成构建期间将运行时脚本嵌入到 index.html 中。设置为 false 时,脚本将不会嵌入,并将照常导入。在处理 CSP 时通常需要这样做。
← PreviousNext →
Create React App 中文文档
文档
快速入门学习 React
社区
Stack OverflowSpectrumTwitter
更多
GitHubStar
Facebook Open Source
Copyright © 2018 Facebook Inc.