本教程旨在解决React JS初学者在HTML中加载JavaScript文件时遇到的常见问题，特别是涉及JSX转换和React版本兼容性。文章将详细阐述`script`标签中`type="text/babel"`属性的重要性、React 17和React 18中渲染API的区别，以及在本地开发环境中可能遇到的CORS策略限制及其解决方案，帮助开发者正确配置环境，顺利进行React实践。
在学习React JS的初期，开发者常常选择通过CDN引入React库和Babel进行快速原型开发。然而，在将包含JSX语法的JavaScript文件链接到HTML时，可能会遇到页面空白、控制台报错等问题。这通常源于对Babel转换机制的误解、React API版本差异以及本地文件服务环境的限制。
1. 理解JSX转换与脚本类型
React应用的核心之一是JSX，它允许我们在JavaScript中编写类似HTML的结构。然而，浏览器本身并不直接识别JSX语法，需要一个转换器（如Babel）将其编译成标准的JavaScript。当我们在HTML中直接引入包含JSX的.js文件时，如果希望Babel在浏览器端进行实时转换，就必须明确告知浏览器该脚本需要特殊处理。
核心问题点： 浏览器默认将<script src="script.js"></script>视为纯JavaScript代码。如果script.js中包含JSX，浏览器会因为无法解析而报错或导致脚本无法执行。
立即学习“前端免费学习笔记（深入）”；
解决方案： 引入babel-standalone库后，需要通过在script标签中添加type="text/babel"属性来指示浏览器，该脚本内容应由babel-standalone进行预处理。
示例代码：
<!DOCTYPE html>
<html>
<head>
<title>React JSX 示例</title>
<link rel="stylesheet" href="index.css">
<!-- 引入 React 库 -->
<script crossorigin src="https://unpkg.com/react@18/umd/react.development.js"></script>
<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@6/babel.min.js"></script>
</head>
<body>
<div id="root"></div>
<!-- 引入你的 React 组件脚本，并指定 type="text/babel" -->
<script src="script.js" type="text/babel"></script>
</body>
</html>在script.js文件中，你可以像往常一样编写包含JSX的React代码：
// script.js
ReactDOM.render(<p>Hello, React 17!</p>, document.getElementById("root")); // 适用于 React 172. 适配React版本API
React在不同版本中，其API可能发生变化，尤其是在主要版本更新时。一个常见的例子是React 17到React 18的渲染方式改变。
-
React 17及以前版本： 使用ReactDOM.render()方法将React元素渲染到DOM节点。
// 适用于 React 17 ReactDOM.render( <p>Hello, React 17!</p>, document.getElementById("root") ); -
React 18及以后版本： 引入了并发模式（Concurrent Mode），并推荐使用ReactDOM.createRoot()创建一个根节点，然后调用其render()方法。ReactDOM.render()在React 18中已被标记为遗留API，会触发控制台警告。
// 适用于 React 18 const root = ReactDOM.createRoot(document.getElementById("root")); root.render( <p>Hello, React 18!</p> );
注意事项： 确保你引入的React库版本与你JS文件中使用的渲染API相匹配。如果你引入的是React 18的CDN，但仍使用ReactDOM.render()，页面虽然可能显示，但控制台会输出警告信息。
3. 本地文件加载与CORS策略
当你在浏览器中直接打开一个本地HTML文件（例如file:///D:/Ventures/React%20tutorial/index.html），并尝试通过babel-standalone加载本地的script.js文件时，你可能会遇到“CORS policy: Cross origin requests are only supported for protocol schemes: http, isolated-app, brave, https...”这样的错误。
原因分析： babel-standalone在浏览器中转换JSX时，它需要通过XMLHttpRequest（XHR）或fetch API来读取type="text/babel"的脚本内容。出于安全考虑，浏览器对file://协议下的XHR请求有严格的CORS（跨域资源共享）限制，通常不允许从本地文件系统加载其他本地文件。
解决方案： 为了在本地进行开发，你需要通过一个本地HTTP服务器来提供文件服务，而不是直接在浏览器中打开HTML文件。这样，浏览器会通过http://或https://协议访问你的文件，从而避免CORS限制。
推荐工具：
- VS Code Live Server 扩展： 这是最便捷的解决方案之一。安装后，右键点击HTML文件选择“Open with Live Server”，它会自动启动一个本地服务器（如http://127.0.0.1:5500/index.html）来服务你的文件。
- Node.js http-server： 如果你安装了Node.js，可以通过npm install -g http-server全局安装，然后在项目根目录运行http-server命令。
- Python SimpleHTTPServer： 在项目根目录运行python -m http.server (Python 3) 或 python -m SimpleHTTPServer (Python 2)。
使用本地服务器后，babel-standalone就能正常通过HTTP请求加载并转换你的script.js文件，页面也就能正常显示了。
总结与最佳实践
要确保你的React JS脚本在HTML中正确加载并显示内容，请遵循以下关键点：
- 为JSX脚本添加type="text/babel"： 这是让babel-standalone在浏览器中转换JSX的必要条件。
- 匹配React版本与渲染API： 根据你引入的React库版本（React 17或React 18），使用对应的渲染方法（ReactDOM.render()或ReactDOM.createRoot().render()）。
- 使用本地HTTP服务器进行开发： 避免直接打开file://协议的HTML文件，以解决CORS策略问题，确保babel-standalone能正常加载本地脚本。
- 检查浏览器控制台： 始终关注浏览器的开发者工具控制台，任何错误或警告信息都可能指出问题的根源。
- 生产环境考虑： 在实际项目开发中，通常不建议在浏览器端进行JSX转换，因为这会增加客户端的负担并影响性能。更常见的做法是使用构建工具（如Webpack、Vite、Parcel）在开发阶段将JSX预编译为纯JavaScript，然后部署编译后的文件。
通过理解和应用这些原则，你可以有效解决React JS初学者在设置开发环境时遇到的脚本加载和渲染问题，为后续的React学习打下坚实的基础。
