Reflex v0.9.x 版本演进全解析从多应用注册上下文到 React Router 8 迁移【免费下载链接】reflex️ Web apps in pure Python 项目地址: https://gitcode.com/GitHub_Trending/re/reflex本指南基于 Reflex 开源仓库根目录的 CHANGELOG.md覆盖 v0.9.4 至 v0.9.9 共六个版本系统梳理框架在注册模型、运行时、编译产物、CLI、性能与工程化层面的关键演进。你将掌握RegistrationContext多应用共存机制的正确用法、rx.memo/hybrid_property等新一代 API 的迁移要点、React Router 8 升级带来的依赖变更以及reflex run/reflex deploy新增命令行参数的实际语义。文中所有关键结论均可回溯到 reflex/、packages/ 下的对应源码与 tests/ 中的测试用例。v0.9.9注册上下文落地多应用同进程共存v0.9.92026-08-28 发布是本轮演进的里程碑核心变化是把框架的全局注册状态收敛到RegistrationContext为多应用、多测试夹具同进程共存铺平道路。RegistrationContext从模块级全局到上下文作用域过去当前App、已加载的Config、rx.page注册信息以及 bundled-library 注册表都是模块级全局变量多个应用或测试脚手架harness在同一进程内运行时会互相污染注册信息。v0.9.9 将这些状态全部收归当前活动的RegistrationContext实现真正的隔离对应 issue #6382。在源码中RegistrationContext是reflex_base.registry中一个 frozen dataclass持有事件处理器映射、基础状态类、装饰页面列表、bundled libraries 与关联的App/Configregistry.py。它通过 context-var 机制cls._context_var在进程内维护当前上下文ensure_context()在无上下文时自动创建并绑定registry.py。破坏性变更一个RegistrationContext只能关联一个App实例。v0.9.8 允许在同一进程内创建第二个裸rx.App()v0.9.9 起会抛出ReflexRuntimeError。源码中_set_app明确检查若_app已被占用则提示使用fork()派生新上下文后再实例化新 Appregistry.py。多应用正确姿势需要创建多个应用时请使用RegistrationContext.fork()。fork 会浅拷贝既有注册信息事件处理器、基础状态、页面、bundled libraries并重置_app与_config使 fork 后的上下文可以独立演化、重新加载rxconfig.pyregistry.py。两个随之而来的弃用项弃用符号替代方案移除版本reflex.components.dynamic.bundled_libraries与DEFAULT_BUNDLED_LIBRARIES#6967RegistrationContext.ensure_context().bundled_libraries读取bundle_library()/reset_bundled_libraries()修改1.0reflex.page.DECORATED_PAGES#6985RegistrationContext.ensure_context().decorated_pages按应用名映射1.0两者在过渡期保持可用仅解析目标改为活动上下文。前端状态回传client_error 套接字事件v0.9.9 新增client_errorsocket 事件把前端无法处理的状态增量delta回传给后端并在终端记录可操作的错误日志而不是静默失败。前后端状态不一致对会话是致命的后续事件将停止直到前端重建或修正api_url后刷新页面#6827。实现层面EventNamespace.on_client_error会先校验载荷是否为 dict非法载荷直接丢弃而不抛异常——这修复了 v0.9.9 中另一个 bug无载荷的client_erroremit 不再触发 python-socketio 分发中的TypeError从而堵住了无 token socket 刷 asyncio traceback 的后门#6984。日志系统重构标准 logging JSON 行输出v0.9.9 将框架日志接入标准 Pythonlogging使用按模块划分的 loggerreflex_base.utils.log并以reflex.utils.log重导出在import reflex时完成引导。Rich 彩色输出保留设置REFLEX_LOG_JSON可输出机器可读的 JSON-lines 记录--loglevel critical不再打印 system-info 横幅#6863。日志管道的实现位于 log.py在 CLI或其子进程内挂载三个 sink——Rich 控制台 handler保留与旧版 console 助手一致的配色、JSON-lines handler由REFLEX_LOG_JSON或--json开启、以及可选的REFLEX_ENABLE_FULL_LOGGING/REFLEX_LOG_FILE文件 handler。在 CLI 之外不附加任何 handler记录传播到 root logger交由应用自身的日志配置处理。新增的--jsonCLI 标志与REFLEX_LOG_JSON等价#6865。配套修复控制台告警与错误不再打印字面反斜杠转义的方括号如dict\[str, str]因为日志管道以 markup 禁用模式渲染消息方括号内的类型名现在原样输出VarAttributeError消息同步去掉转义#6989。React Router 8 升级依赖迁移清单编译后的前端从 React Router 7.18.2 升级到 8.3.0作为结果 Reflex 要求Node 22.22.0 或更新版本#6854。默认生成的应用无需改动rxconfig.py或应用代码唯一必须修改的是自定义组件上游已不再存在react-router-dom包也不再随 Reflex 安装自定义组件中的library react-router-dom必须改为react-router若使用RouterProvider/HydratedRouter则写react-router/dom。本次升级还带来两个工程化连锁反应生成物精简生成的package.json不再携带框架自有的postcssoverride固定的postcssdev 依赖已能保证所有传递依赖解析到唯一副本。已安装 0.9.8 的项目会在reflex.lock/package.json中残留一条惰性postcss: 8.5.23override与 dev 依赖 pin 一致、无实际影响可手工删除#6854。Node 版本门槛v0.9.9 修复了reflex run在无 node 环境bun-only下退出restartWithMergedOptions() was called...的问题——现在 dev server 通过NODE_OPTIONS/BUN_OPTIONS预启用development导出条件#6857AppHarness也做了同样的修复#6931。reflex deploy 增强GCP 部署参数全覆盖v0.9.9 为reflex deploy补充了四个部署控制参数#6884、#6908参数作用--min-instances/--max-instances设置部署到 Google Cloud 应用的自动扩缩边界省略则保持原值--gcp-connection选择组织下已连接的 GCP 账号来执行部署--full-deploy前端由云厂商自己的容器提供服务而非 Reflex CDN--strategy此前只能在配置文件中设置现在成为命令行参数配套文档更新了provider、gcp_connection、full_deploy云配置项说明 Google Cloud 目标忽略哪些设置、以及为何full_deploy默认留空而非 false#6908。v0.9.8 还引入了--provider部署到 Reflex Cloud 或组织已连接的 GCP 账号与--description在部署上记录可选变更说明显示于reflex cloud apps history。架构调整v0.9.9 将reflex deploy命令实现从reflex包迁移到独立的reflex-hosting-cli包#6924云相关代码不再随框架发布。reflex-hosting-cli仍是reflex的依赖因此reflex deploy与reflex cloud开箱即用若该包未安装命令会提示应安装哪个包而不是报命令缺失。编译产物与 React DevTools 可调试性v0.9.9 大幅改善了编译产物的可读性#6945memo 化组件从 Python 类或rx.memo函数继承displayName不再显示为Anonymous生成的 context 有了名字如StateContext(reflex___state____state.my_state).Provider而非无标签的Context.Provider页面按其路由标注Component(blog/[slug])client-only 的NoSSRComponent包装渲染为ClientSide(Tag)。同时rx.script的 head 更新改为同步 flush替代 react-helmet 基于 requestAnimationFrame 的批处理修复了水合后 script 标签偶发缺失scripts not loaded的问题#6905。性能优化调度、渲染与代理读取v0.9.9 的性能改动集中在三个层面事件调度移除EventNamespace.emit_update中每次更新都执行的asyncio.create_task包装将每条外发状态更新的调度开销降低约一半#6734。开发模式渲染开发模式不再为每个元素捕获 React owner-stack大型应用中导航点击的主线程 CPU 时间从约 350ms 降至约 83ms5.6x 生产开销降至约 1.3x。代价是React.captureOwnerStack()在开发模式不再返回 owner 帧影响 React DevTools 的 owner-stack 视图与依赖该 API 的自定义错误浮层设置REFLEX_REACT_OWNER_STACKS1可恢复#6905。调用点自动 memoprops 绑定到状态的rx.memo组件现在会在调用点自动 memo 化——这些 props 所需的状态 hooks 编译进一个生成的包装组件而非页面模块状态变化时只重渲染包装组件而不是整页且 React 的memo在 prop 值未变时到此为止#6949。v0.9.7 与 v0.9.5 的性能改进同样值得关注匿名遥测改到专用单 worker 后台线程避免阻塞 asyncio 事件循环#6626事件链yield OtherState.handler(rows)不再深拷贝未绑定状态的载荷值无代理载荷的事件链提速约 5 倍#6739MutableProxy读取大型容器列表、dict、dataclass的开销降低约 3-4 倍#6600。新一代组件与状态 APIrx.memo从实验 API 到一等公民v0.9.4 起rx._x.memo弃用统一为rx.memo#6517rx.memo组件现接受rx.EventHandler参数并携带注解返回类型调用点类型检查更严格。新增rx.EMPTY_VAR_COMPONENT哨兵值作为rx.memo的children槽及任何rx.Var[rx.Component]prop的默认值与rx.EMPTY_VAR_STR/rx.EMPTY_VAR_INT配套#6598。注解要求1.0 将强制执行rx.memo期望每个参数标注为rx.Var[...]或rx.RestProp/rx.EventHandler函数声明rx.Component或rx.Var[...]返回类型。仍使用裸 Python 类型如name: str或省略返回注解的 memo 继续工作值会被强转为rx.Var[...]/rx.Component但会触发弃用警告#6598。惰性求值memo 装饰的函数体改为首次使用组件实例化或编译时求值而非 import 时加快启动并规避装饰期间的循环导入错误#6598。可配置 JS 包装v0.9.7rx.memo支持wrapper参数——默认使用 Reactmemowrapper可换入自定义函数Var其 imports 随生成模块携带wrapperNone输出裸函数组件#6730。输出路径镜像源码模块v0.9.6自动 memo 组件编译到.web/app_components/路径镜像其定义所在的 Python 源码模块不再挤进单一components.jsxauto-memo 注册表按源码模块隔离同名 memo 带稳定模块后缀、互不冲突源码变更时清理过期 memo 文件#6457。hybrid_property一个属性前后端通用rx._x.hybrid_propertyv0.9.4 引入issue #3806像普通 Python property 一样在后端工作同时能在前端类级别渲染。v0.9.6 将其适用范围从State类扩展到 dataclass、pydantic 模型与 SQLAlchemy 模型#6617并通过对象 var如State.info.a_b在前端按 var 渲染前后端共用同一份代码。v0.9.6 还让前端逻辑读取后端下划线前缀状态 var 时抛出明确错误而不是静默把服务端默认值烘焙进前端——此时应引用普通 var或用name.var提供独立的前端实现#6621。状态与事件修复后台任务竞态修复收尾中的后台任务可能丢弃并发事件处理器已提交、尚未到达前端的状态更新的竞态从不进入async with self的后台处理器仍会发出其 delta现在在状态锁下计算#6920。on_load 生命周期同一客户端的新导航会取消上一页面未完成的on_load事件链包括rx.event(backgroundTrue)的后台任务0.9.8 会让其跑完由其他事件启动的后台任务不受影响#6593。TypedDict 表单rx.form的on_submit处理器可将表单参数标注为TypedDict含typing_extensions.NotRequired字段构建时表单会静态校验控件是否提供每个必填字段缺失时抛EventHandlerValueError并列出缺失/已提供字段。表单设置id或控件标识为动态Var时跳过校验#6301。State 判定修复State.get_var_value()不再对 Var 运算如State.a State.b、State.items[0]静默返回错误值而是抛UnretrievableVarValueError#6633BaseState上被BaseState.dict遮蔽的dict注解现在限定为内置类型类型检查器可正确解析#6846。路由与热重载catchall 路由前缀误匹配修复[[...splat]]catchall 路由不再匹配仅共享前缀的路径——posts/[[...splat]]此前会连/postsomething一起匹配导致错误页面的on_load触发#6790。动态/静态段共存静态段与另一路由动态段对齐时如/posts/all/[x]与/posts/[id]并存不再误报RouteValueErrorReact Router 优先解析静态段仅同位置两个不同名的动态段才冲突且该检查不再依赖路由添加顺序#6953。热重载路径覆盖新增REFLEX_HOT_RELOAD_OVERRIDE_PATHS环境变量冒号分隔路径列表设置后完全替换 dev 模式监视的热重载路径优先级高于配置派生默认值及REFLEX_HOT_RELOAD_INCLUDE_PATHS/REFLEX_HOT_RELOAD_EXCLUDE_PATHS#6639。配置与运行模式default_color_mode首屏不再闪主题v0.9.7 为rx.Config新增default_color_mode可选system、light、dark也可用REFLEX_DEFAULT_COLOR_MODE设置应用可在不引入大型 Radix themes CSS 的情况下设定初始颜色模式并直接使用内置颜色模式切换器与rx.color_mode_cond。该值同时驱动编译后的ThemeProvider默认值与水合前的 preload 脚本首帧不会闪现错误主题显式rx.theme(appearance...)优先级更高#6716。源码中default_color_mode默认为system并在校验时约束取值必须属于LiteralColorMode允许集config.py、config.py。preload 脚本由preload_color_theme(default_color_modesystem)生成用于防止 FOUCmisc.py。frozen_lockfile锁文件冻结默认开启v0.9.7 新增frozen_lockfile配置默认True开启时 bun 的首次安装以--frozen-lockfile运行锁文件与package.json不同步时快速失败设为False则允许锁文件就地更新。npm 目前没有等价安装标志因此该选项对 npm 无效#6763。配套修复升级到新增package.jsonoverride 的 Reflex 版本后reflex run不再报error: lockfile had changes, but lockfile is frozen——override 在reflex.lock/锁文件安装完成后应用#6844。preview 运行模式v0.9.8 新增reflex run --env preview像 dev 一样热重载但服务的是新构建、未压缩的前端 bundle挂载进后端而非运行 Vite dev server。默认关闭压缩、CSS 压缩、autoprefixer 与 sourcemap 以换取更快构建与可读输出分别可用VITE_MINIFY、REFLEX_NO_AUTOPREFIXER、VITE_SOURCEMAP覆盖#6663。hydrate_fallback水合窗口占位v0.9.5 新增App.hydrate_fallback在水合窗口React Router 的HydrateFallback渲染指定组件替代白屏也可通过hydrate_fallback配置项无代码配置——指向无参可调用对象的点分导入路径可用REFLEX_HYDRATE_FALLBACK环境变量设置App参数优先。注意 fallback 仅覆盖 JS bundle 加载完成后的水合窗口不覆盖最初的 bundle 下载#6630。CLI 与工程化reflex init行为变化v0.9.6 起reflex init会在AGENTS.md写入 Reflex 管理的章节从规范来源获取、以标记分隔以保留用户内容并为 Claude Code 生成导入AGENTS.md的CLAUDE.md若已有未含 import 的CLAUDE.md则直接管理其中的章节#6620 的_plan_agents_md/initialize_agents_md。reflex component build兼容性v0.9.8 修复 Python 3.10/3.11 上递归 stub 生成委派给 PyiGenerator 扫描器导致的AttributeError#6760。reflex rename编码修复非 UTF-8 平台 locale 下不再损坏源文件并保留声明的 Python 源码编码与换行符#6761。Windows 修复嵌套/子目录样式表因生成 CSSimport使用反斜杠路径分隔符被 CSS 视为转义序列而加载失败现统一 POSIX 化#6762系统 MIME 注册表把 JS 映射为text/plain时生产前端水合失败问题已修复#6831。reflex run不再挂死前端 worker 线程因致命错误如 npm 路径上的 node 最低版本检查退出而主线程被后端阻塞时失败会中断主线程CLI 携带原始错误及时退出#6990、#6994。进程隔离AppHarnessProd不再把REFLEX_ENV_MODEprod泄漏给同进程后创建的 devAppHarness此前会导致其启用路由预渲染并丢弃水合恢复期间分发的事件#6857。锁文件同步v0.9.6 起安装前先将reflex.lock/package.json同步到.web/package.json保证锁文件与 package.json 对齐#6658。遥测、依赖与安全遥测标识符 UUID 化匿名遥测改用 UUID 字符串报告安装与项目标识符替代 128 位整数——PostHog 会把大整数强转为 float、丢失约 16 位有效数字导致不同安装/应用被关联为同一实体重新编码保持相同 128 位值并用一次性$create_alias关联历史数据#6611。子包版本上报遥测新增reflex_package_version字段上报随 Reflex 发布的一方子包reflex-base、reflex-components-*系列、reflex-hosting-cli版本集合由 Reflex 自身声明依赖推导不会上报无关三方reflex-*包#6610。依赖安全升级v0.9.6 提升starlette1.3.1Host-header 路径投毒、request.form()DoS、UNC-path SSRF、python-multipart0.0.32二次时间 querystring DoS、无界 header 字段大小、parse_form负Content-Length缓冲、granian2.7.4WSGI/WebSocket header-panic DoS最低版本#6665v0.9.8 更新开发依赖 Pillow12.3.0 及锁定的aiohttp3.14.3、cryptography50.0.0清理 CVE-2026-59881、CVE-2026-69243/44/47#6836、#6837。依赖解耦pip install reflex不再安装pydanticpydantic 模型支持在安装了 pydantic 后自动激活。需要它时使用新的reflex[pydantic]extra或reflex[db]#6786。开发工具链与变更管理towncrier 变更管理v0.9.4 引入基于 towncrier 的 changelog 流程——每个改动包源码的 PR 在对应包的news/目录下添加 fragment发布时汇总进CHANGELOG.md#6350。当前仓库各packages/*/news/目录即为该流程的运行实例。make_pyi 脚本 CLI 化scripts/make_pyi.py成为维护pyi_hashes.json的正式 CLI--force全量重建默认目标显式目标合并进注册表而非裁剪分支切换后不可达的 last-run commit 触发全量重建新增--check模式接入 pre-commit CI在pyi_hashes.json条目失去对应.py源文件时报错#6614。工具链升级v0.9.9 升级锁定开发工具ruff0.15.12→0.16.2、pyright1.1.408→1.1.411、typer0.25.1→0.27.1#6893v0.9.8 修复reflex run在升级到新增 override 的 Reflex 版本后 lockfile 冻结报错#6844。升级到 v0.9.9 的检查清单Node 版本确认 Node ≥ 22.22.0bun-only 环境关注NODE_OPTIONS/BUN_OPTIONS的 development 条件修复。自定义组件若引用react-router-dom改为react-routerRouterProvider/HydratedRouter用react-router/dom。多应用进程第二个rx.App()前必须RegistrationContext.fork()否则抛ReflexRuntimeError。弃用符号迁移bundled_libraries/DEFAULT_BUNDLED_LIBRARIES与DECORATED_PAGES到RegistrationContext等价 API。依赖reflex[pydantic]或reflex[db]保留 pydantic 支持。可选行为差异dev 模式默认关闭 owner-stack 捕获REFLEX_REACT_OWNER_STACKS1恢复日志输出改为标准 logging可用--json/REFLEX_LOG_JSON获取 JSON 行。以上各点均可在 CHANGELOG.md 中定位到对应版本小节并在 reflex/、packages/reflex-base/src/reflex_base/ 及 tests/ 中找到实现与验证依据。【免费下载链接】reflex️ Web apps in pure Python 项目地址: https://gitcode.com/GitHub_Trending/re/reflex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Reflex v0.9.x 版本演进全解析：从多应用注册上下文到 React Router 8 迁移
Reflex v0.9.x 版本演进全解析从多应用注册上下文到 React Router 8 迁移【免费下载链接】reflex️ Web apps in pure Python 项目地址: https://gitcode.com/GitHub_Trending/re/reflex本指南基于 Reflex 开源仓库根目录的 CHANGELOG.md覆盖 v0.9.4 至 v0.9.9 共六个版本系统梳理框架在注册模型、运行时、编译产物、CLI、性能与工程化层面的关键演进。你将掌握RegistrationContext多应用共存机制的正确用法、rx.memo/hybrid_property等新一代 API 的迁移要点、React Router 8 升级带来的依赖变更以及reflex run/reflex deploy新增命令行参数的实际语义。文中所有关键结论均可回溯到 reflex/、packages/ 下的对应源码与 tests/ 中的测试用例。v0.9.9注册上下文落地多应用同进程共存v0.9.92026-08-28 发布是本轮演进的里程碑核心变化是把框架的全局注册状态收敛到RegistrationContext为多应用、多测试夹具同进程共存铺平道路。RegistrationContext从模块级全局到上下文作用域过去当前App、已加载的Config、rx.page注册信息以及 bundled-library 注册表都是模块级全局变量多个应用或测试脚手架harness在同一进程内运行时会互相污染注册信息。v0.9.9 将这些状态全部收归当前活动的RegistrationContext实现真正的隔离对应 issue #6382。在源码中RegistrationContext是reflex_base.registry中一个 frozen dataclass持有事件处理器映射、基础状态类、装饰页面列表、bundled libraries 与关联的App/Configregistry.py。它通过 context-var 机制cls._context_var在进程内维护当前上下文ensure_context()在无上下文时自动创建并绑定registry.py。破坏性变更一个RegistrationContext只能关联一个App实例。v0.9.8 允许在同一进程内创建第二个裸rx.App()v0.9.9 起会抛出ReflexRuntimeError。源码中_set_app明确检查若_app已被占用则提示使用fork()派生新上下文后再实例化新 Appregistry.py。多应用正确姿势需要创建多个应用时请使用RegistrationContext.fork()。fork 会浅拷贝既有注册信息事件处理器、基础状态、页面、bundled libraries并重置_app与_config使 fork 后的上下文可以独立演化、重新加载rxconfig.pyregistry.py。两个随之而来的弃用项弃用符号替代方案移除版本reflex.components.dynamic.bundled_libraries与DEFAULT_BUNDLED_LIBRARIES#6967RegistrationContext.ensure_context().bundled_libraries读取bundle_library()/reset_bundled_libraries()修改1.0reflex.page.DECORATED_PAGES#6985RegistrationContext.ensure_context().decorated_pages按应用名映射1.0两者在过渡期保持可用仅解析目标改为活动上下文。前端状态回传client_error 套接字事件v0.9.9 新增client_errorsocket 事件把前端无法处理的状态增量delta回传给后端并在终端记录可操作的错误日志而不是静默失败。前后端状态不一致对会话是致命的后续事件将停止直到前端重建或修正api_url后刷新页面#6827。实现层面EventNamespace.on_client_error会先校验载荷是否为 dict非法载荷直接丢弃而不抛异常——这修复了 v0.9.9 中另一个 bug无载荷的client_erroremit 不再触发 python-socketio 分发中的TypeError从而堵住了无 token socket 刷 asyncio traceback 的后门#6984。日志系统重构标准 logging JSON 行输出v0.9.9 将框架日志接入标准 Pythonlogging使用按模块划分的 loggerreflex_base.utils.log并以reflex.utils.log重导出在import reflex时完成引导。Rich 彩色输出保留设置REFLEX_LOG_JSON可输出机器可读的 JSON-lines 记录--loglevel critical不再打印 system-info 横幅#6863。日志管道的实现位于 log.py在 CLI或其子进程内挂载三个 sink——Rich 控制台 handler保留与旧版 console 助手一致的配色、JSON-lines handler由REFLEX_LOG_JSON或--json开启、以及可选的REFLEX_ENABLE_FULL_LOGGING/REFLEX_LOG_FILE文件 handler。在 CLI 之外不附加任何 handler记录传播到 root logger交由应用自身的日志配置处理。新增的--jsonCLI 标志与REFLEX_LOG_JSON等价#6865。配套修复控制台告警与错误不再打印字面反斜杠转义的方括号如dict\[str, str]因为日志管道以 markup 禁用模式渲染消息方括号内的类型名现在原样输出VarAttributeError消息同步去掉转义#6989。React Router 8 升级依赖迁移清单编译后的前端从 React Router 7.18.2 升级到 8.3.0作为结果 Reflex 要求Node 22.22.0 或更新版本#6854。默认生成的应用无需改动rxconfig.py或应用代码唯一必须修改的是自定义组件上游已不再存在react-router-dom包也不再随 Reflex 安装自定义组件中的library react-router-dom必须改为react-router若使用RouterProvider/HydratedRouter则写react-router/dom。本次升级还带来两个工程化连锁反应生成物精简生成的package.json不再携带框架自有的postcssoverride固定的postcssdev 依赖已能保证所有传递依赖解析到唯一副本。已安装 0.9.8 的项目会在reflex.lock/package.json中残留一条惰性postcss: 8.5.23override与 dev 依赖 pin 一致、无实际影响可手工删除#6854。Node 版本门槛v0.9.9 修复了reflex run在无 node 环境bun-only下退出restartWithMergedOptions() was called...的问题——现在 dev server 通过NODE_OPTIONS/BUN_OPTIONS预启用development导出条件#6857AppHarness也做了同样的修复#6931。reflex deploy 增强GCP 部署参数全覆盖v0.9.9 为reflex deploy补充了四个部署控制参数#6884、#6908参数作用--min-instances/--max-instances设置部署到 Google Cloud 应用的自动扩缩边界省略则保持原值--gcp-connection选择组织下已连接的 GCP 账号来执行部署--full-deploy前端由云厂商自己的容器提供服务而非 Reflex CDN--strategy此前只能在配置文件中设置现在成为命令行参数配套文档更新了provider、gcp_connection、full_deploy云配置项说明 Google Cloud 目标忽略哪些设置、以及为何full_deploy默认留空而非 false#6908。v0.9.8 还引入了--provider部署到 Reflex Cloud 或组织已连接的 GCP 账号与--description在部署上记录可选变更说明显示于reflex cloud apps history。架构调整v0.9.9 将reflex deploy命令实现从reflex包迁移到独立的reflex-hosting-cli包#6924云相关代码不再随框架发布。reflex-hosting-cli仍是reflex的依赖因此reflex deploy与reflex cloud开箱即用若该包未安装命令会提示应安装哪个包而不是报命令缺失。编译产物与 React DevTools 可调试性v0.9.9 大幅改善了编译产物的可读性#6945memo 化组件从 Python 类或rx.memo函数继承displayName不再显示为Anonymous生成的 context 有了名字如StateContext(reflex___state____state.my_state).Provider而非无标签的Context.Provider页面按其路由标注Component(blog/[slug])client-only 的NoSSRComponent包装渲染为ClientSide(Tag)。同时rx.script的 head 更新改为同步 flush替代 react-helmet 基于 requestAnimationFrame 的批处理修复了水合后 script 标签偶发缺失scripts not loaded的问题#6905。性能优化调度、渲染与代理读取v0.9.9 的性能改动集中在三个层面事件调度移除EventNamespace.emit_update中每次更新都执行的asyncio.create_task包装将每条外发状态更新的调度开销降低约一半#6734。开发模式渲染开发模式不再为每个元素捕获 React owner-stack大型应用中导航点击的主线程 CPU 时间从约 350ms 降至约 83ms5.6x 生产开销降至约 1.3x。代价是React.captureOwnerStack()在开发模式不再返回 owner 帧影响 React DevTools 的 owner-stack 视图与依赖该 API 的自定义错误浮层设置REFLEX_REACT_OWNER_STACKS1可恢复#6905。调用点自动 memoprops 绑定到状态的rx.memo组件现在会在调用点自动 memo 化——这些 props 所需的状态 hooks 编译进一个生成的包装组件而非页面模块状态变化时只重渲染包装组件而不是整页且 React 的memo在 prop 值未变时到此为止#6949。v0.9.7 与 v0.9.5 的性能改进同样值得关注匿名遥测改到专用单 worker 后台线程避免阻塞 asyncio 事件循环#6626事件链yield OtherState.handler(rows)不再深拷贝未绑定状态的载荷值无代理载荷的事件链提速约 5 倍#6739MutableProxy读取大型容器列表、dict、dataclass的开销降低约 3-4 倍#6600。新一代组件与状态 APIrx.memo从实验 API 到一等公民v0.9.4 起rx._x.memo弃用统一为rx.memo#6517rx.memo组件现接受rx.EventHandler参数并携带注解返回类型调用点类型检查更严格。新增rx.EMPTY_VAR_COMPONENT哨兵值作为rx.memo的children槽及任何rx.Var[rx.Component]prop的默认值与rx.EMPTY_VAR_STR/rx.EMPTY_VAR_INT配套#6598。注解要求1.0 将强制执行rx.memo期望每个参数标注为rx.Var[...]或rx.RestProp/rx.EventHandler函数声明rx.Component或rx.Var[...]返回类型。仍使用裸 Python 类型如name: str或省略返回注解的 memo 继续工作值会被强转为rx.Var[...]/rx.Component但会触发弃用警告#6598。惰性求值memo 装饰的函数体改为首次使用组件实例化或编译时求值而非 import 时加快启动并规避装饰期间的循环导入错误#6598。可配置 JS 包装v0.9.7rx.memo支持wrapper参数——默认使用 Reactmemowrapper可换入自定义函数Var其 imports 随生成模块携带wrapperNone输出裸函数组件#6730。输出路径镜像源码模块v0.9.6自动 memo 组件编译到.web/app_components/路径镜像其定义所在的 Python 源码模块不再挤进单一components.jsxauto-memo 注册表按源码模块隔离同名 memo 带稳定模块后缀、互不冲突源码变更时清理过期 memo 文件#6457。hybrid_property一个属性前后端通用rx._x.hybrid_propertyv0.9.4 引入issue #3806像普通 Python property 一样在后端工作同时能在前端类级别渲染。v0.9.6 将其适用范围从State类扩展到 dataclass、pydantic 模型与 SQLAlchemy 模型#6617并通过对象 var如State.info.a_b在前端按 var 渲染前后端共用同一份代码。v0.9.6 还让前端逻辑读取后端下划线前缀状态 var 时抛出明确错误而不是静默把服务端默认值烘焙进前端——此时应引用普通 var或用name.var提供独立的前端实现#6621。状态与事件修复后台任务竞态修复收尾中的后台任务可能丢弃并发事件处理器已提交、尚未到达前端的状态更新的竞态从不进入async with self的后台处理器仍会发出其 delta现在在状态锁下计算#6920。on_load 生命周期同一客户端的新导航会取消上一页面未完成的on_load事件链包括rx.event(backgroundTrue)的后台任务0.9.8 会让其跑完由其他事件启动的后台任务不受影响#6593。TypedDict 表单rx.form的on_submit处理器可将表单参数标注为TypedDict含typing_extensions.NotRequired字段构建时表单会静态校验控件是否提供每个必填字段缺失时抛EventHandlerValueError并列出缺失/已提供字段。表单设置id或控件标识为动态Var时跳过校验#6301。State 判定修复State.get_var_value()不再对 Var 运算如State.a State.b、State.items[0]静默返回错误值而是抛UnretrievableVarValueError#6633BaseState上被BaseState.dict遮蔽的dict注解现在限定为内置类型类型检查器可正确解析#6846。路由与热重载catchall 路由前缀误匹配修复[[...splat]]catchall 路由不再匹配仅共享前缀的路径——posts/[[...splat]]此前会连/postsomething一起匹配导致错误页面的on_load触发#6790。动态/静态段共存静态段与另一路由动态段对齐时如/posts/all/[x]与/posts/[id]并存不再误报RouteValueErrorReact Router 优先解析静态段仅同位置两个不同名的动态段才冲突且该检查不再依赖路由添加顺序#6953。热重载路径覆盖新增REFLEX_HOT_RELOAD_OVERRIDE_PATHS环境变量冒号分隔路径列表设置后完全替换 dev 模式监视的热重载路径优先级高于配置派生默认值及REFLEX_HOT_RELOAD_INCLUDE_PATHS/REFLEX_HOT_RELOAD_EXCLUDE_PATHS#6639。配置与运行模式default_color_mode首屏不再闪主题v0.9.7 为rx.Config新增default_color_mode可选system、light、dark也可用REFLEX_DEFAULT_COLOR_MODE设置应用可在不引入大型 Radix themes CSS 的情况下设定初始颜色模式并直接使用内置颜色模式切换器与rx.color_mode_cond。该值同时驱动编译后的ThemeProvider默认值与水合前的 preload 脚本首帧不会闪现错误主题显式rx.theme(appearance...)优先级更高#6716。源码中default_color_mode默认为system并在校验时约束取值必须属于LiteralColorMode允许集config.py、config.py。preload 脚本由preload_color_theme(default_color_modesystem)生成用于防止 FOUCmisc.py。frozen_lockfile锁文件冻结默认开启v0.9.7 新增frozen_lockfile配置默认True开启时 bun 的首次安装以--frozen-lockfile运行锁文件与package.json不同步时快速失败设为False则允许锁文件就地更新。npm 目前没有等价安装标志因此该选项对 npm 无效#6763。配套修复升级到新增package.jsonoverride 的 Reflex 版本后reflex run不再报error: lockfile had changes, but lockfile is frozen——override 在reflex.lock/锁文件安装完成后应用#6844。preview 运行模式v0.9.8 新增reflex run --env preview像 dev 一样热重载但服务的是新构建、未压缩的前端 bundle挂载进后端而非运行 Vite dev server。默认关闭压缩、CSS 压缩、autoprefixer 与 sourcemap 以换取更快构建与可读输出分别可用VITE_MINIFY、REFLEX_NO_AUTOPREFIXER、VITE_SOURCEMAP覆盖#6663。hydrate_fallback水合窗口占位v0.9.5 新增App.hydrate_fallback在水合窗口React Router 的HydrateFallback渲染指定组件替代白屏也可通过hydrate_fallback配置项无代码配置——指向无参可调用对象的点分导入路径可用REFLEX_HYDRATE_FALLBACK环境变量设置App参数优先。注意 fallback 仅覆盖 JS bundle 加载完成后的水合窗口不覆盖最初的 bundle 下载#6630。CLI 与工程化reflex init行为变化v0.9.6 起reflex init会在AGENTS.md写入 Reflex 管理的章节从规范来源获取、以标记分隔以保留用户内容并为 Claude Code 生成导入AGENTS.md的CLAUDE.md若已有未含 import 的CLAUDE.md则直接管理其中的章节#6620 的_plan_agents_md/initialize_agents_md。reflex component build兼容性v0.9.8 修复 Python 3.10/3.11 上递归 stub 生成委派给 PyiGenerator 扫描器导致的AttributeError#6760。reflex rename编码修复非 UTF-8 平台 locale 下不再损坏源文件并保留声明的 Python 源码编码与换行符#6761。Windows 修复嵌套/子目录样式表因生成 CSSimport使用反斜杠路径分隔符被 CSS 视为转义序列而加载失败现统一 POSIX 化#6762系统 MIME 注册表把 JS 映射为text/plain时生产前端水合失败问题已修复#6831。reflex run不再挂死前端 worker 线程因致命错误如 npm 路径上的 node 最低版本检查退出而主线程被后端阻塞时失败会中断主线程CLI 携带原始错误及时退出#6990、#6994。进程隔离AppHarnessProd不再把REFLEX_ENV_MODEprod泄漏给同进程后创建的 devAppHarness此前会导致其启用路由预渲染并丢弃水合恢复期间分发的事件#6857。锁文件同步v0.9.6 起安装前先将reflex.lock/package.json同步到.web/package.json保证锁文件与 package.json 对齐#6658。遥测、依赖与安全遥测标识符 UUID 化匿名遥测改用 UUID 字符串报告安装与项目标识符替代 128 位整数——PostHog 会把大整数强转为 float、丢失约 16 位有效数字导致不同安装/应用被关联为同一实体重新编码保持相同 128 位值并用一次性$create_alias关联历史数据#6611。子包版本上报遥测新增reflex_package_version字段上报随 Reflex 发布的一方子包reflex-base、reflex-components-*系列、reflex-hosting-cli版本集合由 Reflex 自身声明依赖推导不会上报无关三方reflex-*包#6610。依赖安全升级v0.9.6 提升starlette1.3.1Host-header 路径投毒、request.form()DoS、UNC-path SSRF、python-multipart0.0.32二次时间 querystring DoS、无界 header 字段大小、parse_form负Content-Length缓冲、granian2.7.4WSGI/WebSocket header-panic DoS最低版本#6665v0.9.8 更新开发依赖 Pillow12.3.0 及锁定的aiohttp3.14.3、cryptography50.0.0清理 CVE-2026-59881、CVE-2026-69243/44/47#6836、#6837。依赖解耦pip install reflex不再安装pydanticpydantic 模型支持在安装了 pydantic 后自动激活。需要它时使用新的reflex[pydantic]extra或reflex[db]#6786。开发工具链与变更管理towncrier 变更管理v0.9.4 引入基于 towncrier 的 changelog 流程——每个改动包源码的 PR 在对应包的news/目录下添加 fragment发布时汇总进CHANGELOG.md#6350。当前仓库各packages/*/news/目录即为该流程的运行实例。make_pyi 脚本 CLI 化scripts/make_pyi.py成为维护pyi_hashes.json的正式 CLI--force全量重建默认目标显式目标合并进注册表而非裁剪分支切换后不可达的 last-run commit 触发全量重建新增--check模式接入 pre-commit CI在pyi_hashes.json条目失去对应.py源文件时报错#6614。工具链升级v0.9.9 升级锁定开发工具ruff0.15.12→0.16.2、pyright1.1.408→1.1.411、typer0.25.1→0.27.1#6893v0.9.8 修复reflex run在升级到新增 override 的 Reflex 版本后 lockfile 冻结报错#6844。升级到 v0.9.9 的检查清单Node 版本确认 Node ≥ 22.22.0bun-only 环境关注NODE_OPTIONS/BUN_OPTIONS的 development 条件修复。自定义组件若引用react-router-dom改为react-routerRouterProvider/HydratedRouter用react-router/dom。多应用进程第二个rx.App()前必须RegistrationContext.fork()否则抛ReflexRuntimeError。弃用符号迁移bundled_libraries/DEFAULT_BUNDLED_LIBRARIES与DECORATED_PAGES到RegistrationContext等价 API。依赖reflex[pydantic]或reflex[db]保留 pydantic 支持。可选行为差异dev 模式默认关闭 owner-stack 捕获REFLEX_REACT_OWNER_STACKS1恢复日志输出改为标准 logging可用--json/REFLEX_LOG_JSON获取 JSON 行。以上各点均可在 CHANGELOG.md 中定位到对应版本小节并在 reflex/、packages/reflex-base/src/reflex_base/ 及 tests/ 中找到实现与验证依据。【免费下载链接】reflex️ Web apps in pure Python 项目地址: https://gitcode.com/GitHub_Trending/re/reflex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考