You need to enable JavaScript to run this app. React本地开发无报错但DOM不渲染:ReactDOM未输出内容到root节点
优惠活动
大模型
产品
解决方案
定价
更多

React本地开发无报错但DOM不渲染:ReactDOM未输出内容到root节点

问题排查与修复步骤

先确认报错入口

按F12打开浏览器开发者工具,切换到「Console」和「Network」面板,就能看到隐藏的问题:你引用的index.pack.js不存在,要么直接404,要么被本地服务自动返回了html内容,浏览器根本没有执行React相关代码。

逐行修正现有代码的错误

  • 修正index.html的无效样式引用:原代码里的<style rel="stylesheet" src="style.css"></style>是错误写法,style标签不支持src和rel属性,引入外部css要换成<link rel="stylesheet" href="style.css">
  • 修正脚本引用路径:原代码引用的index.pack.js不存在,要改成你实际编写的源文件./index.js
  • 补充Babel转译依赖:type="text/babel"是Scrimba内置环境的专用语法,本地运行必须引入Babel转译脚本,否则浏览器会直接忽略该类型的脚本,不会执行里面的JSX代码
  • 修正模块导入路径:原生浏览器不识别import React from "react"这种裸模块导入,无法直接读取node_modules里的依赖,要手动补全UMD版本的本地文件路径
  • 清理冗余依赖:package.json里的html-server、install、npm都是无效依赖,可直接执行npm uninstall html-server install npm移除
  • 移除冲突配置:删掉package.json里的"type": "module",该配置会让浏览器原生解析ES Module,和Babel转译逻辑冲突
  • 优化本地服务启动参数:启动http-server时加上-c-1参数禁用缓存,避免浏览器加载旧的无效文件,命令为http-server -c-1

修正后的代码参考

index.html

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>My React App</title>
    <link rel="stylesheet" href="style.css" />
  </head>
  <body>
    <div id="root"></div>
    <!-- 先通过npm安装@babel/standalone,再引用本地脚本 -->
    <script src="./node_modules/@babel/standalone/babel.min.js"></script>
    <script type="text/babel" src="./index.js"></script>
  </body>
</html>

注:轻量引入Babel的方案仅适合入门学习使用,生产环境不要用该模式。

index.js

// 替换原有导入语句,指向本地安装的React UMD版本
import React from "./node_modules/react/umd/react.development.js"
import ReactDOM from "./node_modules/react-dom/umd/react-dom.development.js"
ReactDOM.render(<h1>Hello</h1>, document.getElementById("root"))

更省心的长期开发方案

如果不想手动处理路径、转译等零散配置,直接用官方脚手架创建项目,自动完成所有环境配置:

npx create-react-app my-react-demo
cd my-react-demo
npm start

内容的提问来源于stack exchange,提问作者pvcodes

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.16 09:06:02