本教程旨在解决在html中直接集成react js时，javascript文件无法正确链接或内容无法渲染的常见问题。文章将详细阐述使用`babel-standalone`进行jsx转换时`script`标签中`type=”text/babel”`的重要性，区分react 17和react 18的dom渲染api差异，并提供针对本地文件cors错误的解决方案，确保您的react组件能够成功显示。
在前端开发实践中，尤其是在学习React JS的初期阶段，开发者可能会选择通过CDN直接在html文件中引入React库，并使用babel-standalone在浏览器中实时转换JSX语法。然而，在此过程中，常常会遇到javaScript文件未能正确执行或React组件未能成功渲染的问题。本教程将深入探讨这些常见症结，并提供专业的解决方案。
1. 理解type=”text/babel”的重要性
当您在HTML文件中直接编写或链接包含JSX语法的javascript代码时，浏览器本身无法直接解析JSX。为了使浏览器能够理解并执行这些代码，我们需要一个转换器（transpiler）。babel-standalone库正是为此目的而设计，它允许在浏览器环境中进行JSX到标准JavaScript的转换。
然而，仅仅引入babel-standalone库是不够的。浏览器需要被明确告知哪些script标签内的内容需要通过Babel进行处理。这正是type=”text/babel”属性的作用。当script标签包含此属性时，babel-standalone会拦截并处理该标签内的脚本内容，将其中的JSX转换为浏览器可执行的JavaScript代码。
错误示例（缺少type=”text/babel”）：
立即学习“Java免费学习笔记（深入）”；
<script src="script.js"></script> <!-- Babel不会处理此文件 -->正确示例：
<script src="script.js" type="text/babel"></script> <!-- Babel将处理此文件 -->注意事项： 这种在浏览器中进行实时转换的方式主要用于学习和快速原型开发。在生产环境中，通常会使用webpack、vite等构建工具在部署前预编译JSX，以提高性能和加载速度。
2. React DOM渲染API的版本兼容性
React在不同版本之间，尤其是从React 17到React 18，对DOM渲染API进行了重大更新。未能使用与所引入React版本相匹配的渲染方法是导致组件无法显示或控制台报错的常见原因。
2.1 React 17及以前版本
在React 17及更早版本中，我们使用ReactDOM.render()方法将React元素渲染到DOM节点中。
HTML结构 (React 17)：
<html> <head> <script crossorigin src="https://unpkg.com/react@17/umd/react.development.js"></script> <script crossorigin src="https://unpkg.com/react-dom@17/umd/react-dom.development.js"></script> <script src="https://unpkg.com/babel-standalone@6/babel.min.js"></script> </head> <body> <div id="root"></div> <script src="script.js" type="text/babel"></script> </body> </html>JavaScript代码 (React 17 – script.js)：
ReactDOM.render( <p>Hello from React 17!</p>, document.getElementById("root") );2.2 React 18及以后版本
React 18引入了并发渲染特性，并对根API进行了重构，以更好地支持新的并发功能。ReactDOM.render()方法在React 18中已被弃用，取而代之的是ReactDOM.createRoot().render()。
HTML结构 (React 18)：
<html> <head> <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> <script src="https://unpkg.com/babel-standalone@6/babel.min.js"></script> </head> <body> <div id="root"></div> <script src="script.js" type="text/babel"></script> </body> </html>JavaScript代码 (React 18 – script.js)：
const root = ReactDOM.createRoot(document.getElementById("root")); root.render( <p>Hello from React 18!</p> <div class="aritcle_card"> <a class="aritcle_card_img" href="/ai/986"> <img src="https://img.php.cn/upload/ai_manual/001/503/042/68b6cffcef6cb860.png" alt="Yaara"> </a> <div class="aritcle_card_info"> <a href="/ai/986">Yaara</a> <p>使用AI生成一流的文案广告，电子邮件，网站，列表，博客，故事和更多…</p> <div class=""> <img src="/static/images/card_xiazai.png" alt="Yaara"> <span>95</span> </div> </div> <a href="/ai/986" class="aritcle_card_btn"> <span>查看详情</span> <img src="/static/images/cardxiayige-3.png" alt="Yaara"> </a> </div> );重要提示： 确保您引入的React和ReactDOM CDN版本与您使用的渲染API方法相匹配。混用不同版本的API会导致运行时错误。
3. 本地文件加载与CORS策略
当您直接通过浏览器打开本地HTML文件（例如，通过file:///协议）时，浏览器会实施严格的跨域资源共享（CORS）策略。这意味着通过file:///协议加载的页面，通常无法通过XMLHttpRequest或fetch等API请求其他本地文件，包括由babel-standalone动态加载的JavaScript文件。
常见错误信息：
Access to XMLHttpRequest at 'file:///D:/Ventures/React%20tutorial/script.js' from origin 'null' has been blocked by CORS policy: Cross origin requests are only supported for protocol schemes: http, isolated-app, brave, https, chrome-untrusted, data, chrome-extension, chrome.这个错误表明babel-standalone尝试通过XMLHttpRequest加载您的script.js文件进行转换，但由于CORS策略而被浏览器阻止。
解决方案：
为了避免CORS问题，您应该使用一个本地开发服务器来托管您的HTML文件。这样，文件将通过http://或https://协议提供服务，从而规避file:///协议带来的CORS限制。
常用的本地开发服务器包括：
- VS Code Live Server扩展： 如果您使用VS Code，安装“Live Server”扩展，右键点击HTML文件选择“Open with Live Server”即可启动一个简单的本地服务器。
- http-server (node.js模块)：
4. 完整示例（React 18）
综合上述解决方案，以下是一个完整的、可正常工作的React 18集成示例：
index.html：
<!DOCTYPE html> <html> <head> <title>React JS集成示例</title> <link rel="stylesheet" href="index.css"> <!-- 引入React 18开发版本 --> <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组件的挂载点 --> <!-- 引入您的JavaScript文件，并指定type="text/babel" --> <script src="script.js" type="text/babel"></script> </body> </html>script.js：
// 定义一个简单的React组件 function App() { return ( <div> <h1>欢迎来到React世界！</h1> <p>这是一个使用React 18和Babel在浏览器中渲染的示例。</p> </div> ); } // 获取DOM挂载点 const container = document.getElementById("root"); // 创建React根并渲染组件 const root = ReactDOM.createRoot(container); root.render(<App />);index.css (可选，仅为样式示例)：
body { font-family: sans-serif; margin: 20px; background-color: #f0f2f5; color: #333; } #root { background-color: #fff; padding: 30px; border-radius: 8px; box-shadow: 0 4px 12px rgba(0, 0, 0, 0.1); max-width: 600px; margin: 50px auto; text-align: center; } h1 { color: #28a745; margin-bottom: 15px; } p { font-size: 1.1em; line-height: 1.6; }总结
在HTML中直接集成React JS时，成功的关键在于：
- 正确配置script标签： 对于包含JSX的JavaScript文件，务必添加type=”text/babel”属性，以便babel-standalone能够进行转换。
- 匹配React版本与渲染API： 根据您引入的React版本（17或18），选择正确的DOM渲染方法（ReactDOM.render()或ReactDOM.createRoot().render()）。
- 使用本地开发服务器： 避免通过file:///协议直接打开HTML文件，以解决因CORS策略导致的JavaScript文件加载失败问题。使用Live Server或http-server等工具提供服务。
遵循这些指导原则，您将能够顺利地在HTML环境中启动您的React学习之旅。虽然这种方式对于快速学习和原型开发非常方便，但在实际项目开发中，强烈建议使用现代构建工具（如Vite、Create React App）来管理您的React项目，它们提供了更强大的功能、优化和更好的开发体验。