更新日志
[1.0.0-beta "心灵控制"] - 2026-03-03
🚩 里程碑版本：VuReact 1.0.0-beta —— “心灵控制”
"There is only one true mind." — Yuri
这是 VuReact 的第一个先行版本，代号"心灵控制"。此版本标志着 Vue 到 React 编译从概念验证走向工程实践的重要里程碑。
✨ 核心突破
🧠 心灵控制架构
- 双心智模型支持：开发者可以在 Vue 与 React 两种编程范式间自如切换
- 语义分区能力：编译器能清晰识别并处理不同心智模型的代码区域
- 可控混写模式：支持在同一项目中混合使用 Vue 和 React 语义
⚡ 智能编译引擎
- 完整的编译流水线：实现解析 → 转换 → 生成的完整编译架构
- 深度语法转换：Vue 3 Composition API 到 React Hooks 的智能映射
- 模板指令转换：Vue 模板语法到 JSX 的精确转换
🚀 新增特性
编译能力
- ✅ Vue SFC 完整支持：支持
<template>、<script setup>、<style>三部分编译 - ✅ TypeScript 无缝迁移：完整保留类型定义，自动生成 React 组件类型
- ✅ 零运行时样式：编译时处理 scoped/module 样式，生成静态 CSS
- ✅ 响应式系统适配：
ref、computed、watch等 API 的 React 适配
工程化支持
- ✅ CLI 工具链：提供
build和watch双模式编译 - ✅ 增量编译：基于文件哈希的智能缓存机制
- ✅ Vite 集成：自动初始化标准 React 项目结构
- ✅ 混合开发：支持 Vue 和 React 组件在同一项目中并存
模板转换
- ✅ 基础指令：
v-bind、v-on、v-if、v-for、v-show - ✅ 条件渲染：
v-if/v-else-if/v-else链式转换 - ✅ 列表渲染：
v-for到 JSXmap的智能转换 - ✅ 事件处理：
@click等事件到 React 事件系统的适配
脚本转换
- ✅ 组合式 API：
ref、computed、watch、生命周期函数 - ✅ 组件定义：
defineProps、defineEmits、defineExpose - ✅ 响应式工具：
toRef、toRefs、unref等工具函数 - ✅ 依赖注入：
provide、inject的 React Context 适配
🛠️ 技术架构
核心模块
- 解析层：基于
@vue/compiler-sfc的 Vue SFC 解析 - 转换层：自定义 AST 转换器，生成 React 中间表示
- 生成层：基于 Babel 的代码生成，支持 TypeScript
- 样式处理：PostCSS 管道，支持 Less/Sass 预处理器
运行时适配
- 响应式运行时：
@vureact/runtime-core提供 Vue 风格 API - 路由适配：
@vureact/router支持 Vue Router 到 React Router 转换 - 内置组件：
Transition、KeepAlive等组件的 React 实现
📋 编译约定（首次正式定义）
为确保转换质量，1.0.0 版本明确了以下编译约定：
文件与入口
- 建议只把可控目录纳入
input - 强烈建议把 Vue 入口文件加入
exclude - 先在小目录验证，再扩大范围
Script 约定
- 优先使用
<script setup>语法 - 宏函数必须位于顶层
- Hook 调用必须遵守 React 规则
Template 约定
- 仅使用已支持指令
- 条件分支必须正确嵌套
- 避免复杂动态表达式
Style 约定
- 仅支持首个
style块 scoped与module按规范使用- 避免全局样式副作用
🎯 适用场景
✅ 推荐使用
- 新项目开发：直接按照 VuReact 约定编写 Vue 风格组件
- 渐进式迁移：支持按目录、模块逐步迁移
- 混合开发：允许 Vue 和 React 组件在项目中并存
- 技术栈探索：验证 Vue 到 React 编译的技术可行性
⚠️ 注意事项
- 实验性工具：当前版本优先服务于可控工程场景
- 约定驱动：需要严格遵守编译约定
- 现代语法：专注于 Vue 3 Composition API
🔧 技术栈
- 编译引擎：基于 Babel 和 Vue 官方编译器的混合架构
- 样式处理：PostCSS + 自定义 Scoped CSS 处理器
- 构建工具：Tsup 构建，支持 ESM 和 CJS
- 开发体验：TypeScript 4.9+，ESLint，Prettier
🤝 生态系统
🚨 已知限制
当前版本限制
- 仅支持 Vue 3 Composition API，不兼容 Options API
- 样式仅处理首个
<style>块 - 复杂动态模板表达式可能降级处理
- 自定义指令支持有限
- 宏 API 支持有限
- 暂不支持处理 Vue 入口文件和路由配置文件
未来规划
- 更多 Vue API 的转换/适配
- 状态管理库的转换支持
- UI 组件库的兼容层
- 性能优化和编译速度提升
🙏 致谢
感谢所有参与早期测试和反馈的开发者，你们的宝贵意见帮助 VuReact 不断完善。
特别感谢：
- Vue.js 和 React 社区提供的优秀生态
- 所有开源依赖库的维护者
- 早期采用者的信任和支持
🔮 展望未来
1.0.0-beta "心灵控制"版本是 VuReact 旅程的起点。未来我们将继续探索：
- 更深的转换能力：支持更多 Vue 特性和复杂场景
- 更好的开发体验：改进错误提示和调试工具
- 更广的生态集成：与更多工具和框架集成
- 更强的性能优化：提升编译速度和运行时性能