You need to enable JavaScript to run this app. TypeScript+Parcel使用新JSX转换出现React is not defined错误如何解决
优惠活动
大模型
产品
解决方案
定价
更多

TypeScript+Parcel使用新JSX转换出现React is not defined错误如何解决

移除import React from 'react'后出现React is not defined的修复方案

React 17 新增的免导入React特性依赖编译工具开启新JSX转换能力,你遇到的报错本质是编译工具未正确开启该配置,或是代码/依赖仍在直接调用React全局对象,可按以下场景逐一排查修复:

1. 开启编译工具的新JSX转换配置

针对Babel项目

  • 先升级依赖版本:@babel/core≥v7.9.0,@babel/preset-react≥v7.9.0
  • 修改Babel配置文件(.babelrc / babel.config.json),给preset-react添加runtime参数:
{
  "presets": [
    ["@babel/preset-react", {
      "runtime": "automatic"
    }]
  ]
}

针对TypeScript项目

  • 先升级TypeScript版本≥v4.1
  • 修改tsconfig.json的compilerOptions配置:
{
  "compilerOptions": {
    "jsx": "react-jsx"
  }
}

开发环境下也可以将值改为react-jsxdev,获得更友好的调试提示。

2. 修正直接调用React顶层API的写法

如果你的代码里存在React.useState、React.useEffect、React.memo这类直接调用React全局属性的写法,哪怕开启了新JSX转换,依然会触发未定义报错,改成命名导入即可:

// 仅导入需要用到的API,不需要引入完整React对象
import { useState, useEffect, memo } from 'react'

3. 兼容旧第三方依赖的全局React引用

部分未适配React 17新特性的第三方组件,内部可能仍然直接调用了全局React对象,可以在打包工具里配置全局变量注入:

Webpack配置示例

const webpack = require('webpack')
module.exports = {
  plugins: [
    new webpack.ProvidePlugin({
      React: 'react'
    })
  ]
}

Vite配置示例

安装@vitejs/plugin-react插件并添加到配置中即可,插件会自动处理全局React注入和新JSX转换:

import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'

export default defineConfig({
  plugins: [react()]
})

4. 清理缓存后重新编译

配置修改后如果仍然报错,先删除node_modules/.cache、构建产物目录,再重启开发服务重新编译,避免缓存导致配置未生效。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.18 07:24:08