在 vite 项目中配置 preact,核心做法是安装 @vitejs/plugin-react 并修改 vite.config.js 中的插件配置,将目标切换为 preact。这样做后,vite 就能正确解析 jsx 语法和组件生命周期钩子,无需再手动处理 babel 或复杂的 loader。

如何安装依赖并初始化基础项目
首先需要确保全局安装了 Vite CLI,然后通过官方模板创建项目并安装 Preact 相关包。这一步解决了环境搭建问题,为后续配置提供基础代码结构。

npm create vite@latest my-preact-app -- --template react cd my-preact-app # 删除默认的 React 依赖,安装 Preact npm uninstall react react-dom npm install preact @preact/signals
运行上述命令后,你会得到一个基于 Vite 的项目,但此时它仍指向 React 的 JSX 运行时。接下来需要修改配置文件以适配 Preact。
如何修改 Vite 配置以支持 Preact
修改 vite.config.js 是关键步骤。你需要引入 @vitejs/plugin-react,并将其 babel 选项中的 plugins 替换为 Preact 专用的插件。这确保了编译时能识别 Preact 的 API。

// vite.config.js
import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'
export default defineConfig({
plugins: [
react({
babel: {
plugins: [
['@babel/plugin-transform-react-jsx', { pragma: 'h' }],
['@babel/plugin-transform-react-jsx-self'],
['@babel/plugin-transform-react-jsx-source'],
// 或者使用更简单的 preact 插件
['@preact/preset-vite']
]
}
})
]
})
注意:目前社区更推荐使用 @preact/preset-vite 作为独立插件,而不是通过 @vitejs/plugin-react 间接配置。如果采用推荐方案,配置会更简洁:
// vite.config.js (推荐方式)
import { defineConfig } from 'vite'
import preact from '@preact/preset-vite'
export default defineConfig({
plugins: [preact()],
})
这种配置下,Vite 会自动处理 JSX 转换、别名设置(如 react 指向 preact/compat)以及信号等特性。你只需要在 main.jsx 中正常导入并使用 Preact 组件即可。
如何处理别名冲突与兼容层
当项目中同时存在 React 生态库和 Preact 时,可能会遇到模块解析冲突。Preact 提供了 preact/compat 作为 React 的兼容层,允许大多数 React 应用直接运行。在 Vite 配置中,@preact/preset-vite 默认会设置别名,将 react 和 react-dom 映射到 preact/compat。这意味着你可以直接 import React 而无需修改源码。但如果你的项目中有硬编码的路径引用,可能需要手动检查 node_modules 中的依赖是否也使用了兼容层。此外,若使用 @preact/signals,需确保其版本与 Preact 主包兼容,通常在 package.json 中保持版本号一致即可避免此类问题。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











