在浏览器中直接运行React和JSX：无需构建工具的配置指南-js教程-PHP中文网

在浏览器中直接运行React和JSX：无需构建工具的配置指南

聖光之護

发布： 2025-07-14 23:32:12

原创

620人浏览过

在浏览器中直接运行React和JSX：无需构建工具的配置指南

本文详细阐述了在不使用Webpack、Rollup等前端构建工具的情况下，如何在浏览器中直接运行React应用和JSX代码。核心在于利用CDN引入React和ReactDOM的UMD版本，并通过Babel Standalone在客户端进行JSX代码的实时转译。教程将指导您正确配置HTML和JavaScript文件，避免常见的模块导入错误，实现快速开发与原型验证。

核心概念：UMD、Babel Standalone与浏览器环境

在现代前端开发中，我们通常使用import语句来导入模块，这属于es modules规范。然而，浏览器在不经过构建工具（如webpack、vite）处理的情况下，无法直接解析import react from "react";这类“裸模块说明符”（bare module specifier）。当你在html中直接通过<script src="index.js"></script>加载一个包含import语句的javascript文件时，浏览器会因为无法解析这些模块而报错。

为了在不使用构建工具的情况下在浏览器中直接运行React应用，我们需要依赖以下两个关键点：

UMD (Universal Module Definition) 版本的库：React和ReactDOM提供了UMD格式的构建版本，这些版本可以通过<script>标签直接加载到浏览器中。它们会将React和ReactDOM对象暴露为全局变量（例如window.React和window.ReactDOM），这样你就可以在你的脚本中直接访问它们，而无需使用import语句。
Babel Standalone：React组件通常使用JSX语法编写，这是一种JavaScript的语法扩展。浏览器本身无法直接理解JSX。Babel Standalone是一个在浏览器端运行的Babel版本，它能够在运行时将JSX代码实时转译为标准的JavaScript，从而让浏览器能够执行这些代码。

因此，当你在HTML中通过CDN引入React、ReactDOM的UMD版本以及Babel Standalone后，你的JavaScript文件就不需要使用import语句，而是直接通过全局变量来访问React和ReactDOM。同时，为了让Babel Standalone能够处理你的JSX代码，包含JSX的脚本必须使用type="text/babel"属性来加载。

正确配置HTML文件

为了让浏览器能够正确加载和运行React应用，你的index.html文件需要按照特定的顺序引入必要的CDN脚本，并正确地加载你的应用逻辑脚本。

以下是一个标准的index.html配置示例：

<!DOCTYPE html>
<html lang="en">
<head>
    <title>React应用</title>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <!-- 引入React UMD版本 -->
    <script crossorigin src="https://unpkg.com/react@18/umd/react.development.js"></script>
    <!-- 引入ReactDOM UMD版本 -->
    <script crossorigin src="https://unpkg.com/react-dom@18/umd/react-dom.development.js"></script>
    <!-- 引入Babel Standalone，用于浏览器端JSX转译 -->
    <script src="https://unpkg.com/@babel/standalone/babel.min.js"></script>
</head>
<body>
    <div id="root"></div>
    <!-- 引入你的应用脚本，并指定type="text/babel" -->
    <script type="text/babel" src="index.js"></script>
</body>
</html>

登录后复制

关键点解析：

CDN 顺序：react.development.js 必须在 react-dom.development.js 之前加载，因为 react-dom 依赖于 react。babel.min.js 必须在你的应用脚本 (index.js) 之前加载，因为它需要先准备好转译环境。
crossorigin 属性：对于从CDN加载的脚本，添加 crossorigin 属性有助于处理跨域资源共享（CORS），特别是在错误报告和调试方面。
type="text/babel"：这是至关重要的一步。它告诉浏览器这个<script>标签中的内容（或通过src加载的文件）需要由Babel Standalone进行处理。如果缺少这个属性，浏览器会尝试将其作为普通JavaScript执行，并因无法识别JSX语法而报错。

编写React组件脚本

在你的JavaScript文件（例如index.js）中，你不再需要使用import语句来导入React和ReactDOM。由于它们已经通过UMD版本作为全局变量暴露，你可以直接访问React和ReactDOM。

一览运营宝

一览“运营宝”是一款搭载AIGC的视频创作赋能及变现工具，由深耕视频行业18年的一览科技研发推出。

查看详情

以下是与上述HTML配置相匹配的index.js内容示例：

// 注意：这里不再需要 import React 和 import ReactDOM

const Page = () => (
  <div>
    <h1 className="header">这是一个JSX元素</h1>
    <p>这是一个段落。</p>
  </div>
);

const container = document.getElementById('root');

// 直接使用全局的 ReactDOM 对象进行渲染
ReactDOM.render(<Page />, container);

登录后复制

在这个例子中，Page是一个简单的函数组件，它返回一个包含JSX的React元素。ReactDOM.render()方法被用来将这个React元素渲染到HTML中ID为root的DOM元素内。

注意事项与最佳实践

尽管这种方法可以让你在不使用构建工具的情况下快速启动React项目，但它也有一些重要的注意事项和局限性：

性能开销：Babel Standalone在客户端实时转译代码会带来一定的性能开销。对于大型或复杂的应用，这可能会导致页面加载速度变慢，影响用户体验。
开发效率：虽然省去了配置构建工具的步骤，但这种方式不支持现代前端开发中的一些高级特性，例如热模块替换（HMR）、代码分割（Code Splitting）、CSS预处理器集成等，这会降低开发效率。
生产环境不推荐：由于性能和优化方面的考虑，这种直接在浏览器中进行运行时转译的方法不适合用于生产环境。生产环境的应用通常需要通过Webpack、Vite、Rollup等构建工具进行打包、压缩、优化和Tree Shaking，以获得最佳的性能和加载速度。
适用场景：这种方法最适合以下场景：
- 学习和原型开发：快速验证React概念或构建小型原型，无需复杂的构建设置。
- 简单的演示页面：制作一个简单的、不涉及复杂逻辑的React组件演示。
- CDN环境：在一些特定场景下，可能需要直接从CDN加载所有资源。

总结

理解在浏览器中直接运行React和JSX的原理，对于初学者掌握React的基础概念非常有帮助。它揭示了React应用如何在没有构建工具的辅助下工作，以及Babel在其中扮演的关键角色。然而，对于任何严肃的React项目，尤其是需要部署到生产环境的应用，强烈建议采用现代前端构建工具（如Vite或Create React App生成的项目）来管理依赖、优化代码和提升开发体验。

以上就是在浏览器中直接运行React和JSX：无需构建工具的配置指南的详细内容，更多请关注php中文网其它相关文章！