Reflex 快速入门新手完整构建纯 Python Web 应用指南【免费下载链接】reflex️ Web apps in pure Python 项目地址: https://gitcode.com/GitHub_Trending/re/reflexReflex 是一个让你只用 Python 就能写前后端的 Web 应用框架不用碰 JavaScript。新手最常卡住的地方是装完就报错找不到命令。下面按环境准备、初始化、启动验收三步走读完你就能在本地 3000 端口跑起第一个 Reflex 应用。第一步 · 环境准备一键检查版本Reflex 对运行环境有两点要求Python ≥ 3.10一个 Python 包管理器官方推荐uv也支持 venv、conda、poetry在终端里跑这两条命令做一键检查python --version uv --version检查结果不通过时的修复方式检查结果修复方式Python 低于 3.10从 Python 官网安装 3.10 或更高版本装完重开终端uv: command not found先安装 uv例如pip install uv装完重开终端建议用虚拟环境隔离项目依赖这也是官方文档反复强调的做法参考 docs/getting_started/installation.md。第二步 · 最小可运行路径从空目录到项目在你想放项目的任意目录下执行mkdir my_app cd my_app uv init uv add reflex uv run reflex init每一步做什么mkdir my_appcd my_app建一个项目目录并进入应用名叫什么这个目录就叫什么uv init初始化 Python 项目和虚拟环境uv add reflex把 Reflex 装进项目依赖uv run reflex init生成 Reflex 应用骨架包括页面代码和配置文件rxconfig.pyreflex init会提示你选模板新手直接按提示选(0) A blank Reflex app即可回车确认。两个可能失败的地方紧跟替代方案报reflex: command not found说明你没用项目里的环境。不要用裸命令所有 reflex 命令都加上uv run前缀Windows 报missing a DLL required to run bun.exe这是缺 Visual C 运行时安装 Microsoft Visual C 2015 Redistributable 后重试第三步 · 启动验收首次成功的样子是什么在 my_app 目录下执行uv run reflex run然后在浏览器打开http://localhost:3000。第一次成功的样子是页面正常加载出 Reflex 应用终端日志停在监听状态没有报错。接着验证热更新是否生效修改my_app/my_app.py里页面的一行文字并保存浏览器会自动刷新出新内容不需要重启服务。这是 Reflex 开发模式的核心体验。下面是一个用 Reflex 写的图像生成应用的实际运行效果你可以直观看到纯 Python 写出来的前端是什么形态如果页面打不开或空白按这个顺序排查加--loglevel debug重启查看终端日志里的具体报错按 F12 打开浏览器开发者工具看 Network 标签里哪个请求失败了项目的目录结构.web是编译产物不要手改、assets放静态资源等在 docs/getting_started/project-structure.md 里有完整说明。进阶一自定义端口开发模式下端口被占用时Reflex 会自动改用下一个可用端口所以Address already in use 一般不用慌。如果你要固定端口改项目根目录的rxconfig.pyconfig rx.Config( app_namemy_app, frontend_port3000, backend_port8000, )frontend_port是浏览器访问的端口默认 3000backend_port是后端服务端口默认 8000。改完需要完整重启reflex run。进阶二 容器化部署要部署到服务器或团队协作仓库里自带一套 Docker 示例完整配置见 docker-example/production-compose/compose.prod.yaml。最简部署命令DOMAINexample.com docker compose upDOMAIN填你的实际域名Caddy 会自动完成 TLS 证书签发。需要 Postgres 数据库和 Redis 缓存时再加上compose.prod.yamlDOMAINexample.com docker compose -f compose.yaml -f compose.prod.yaml up -d这套部署会在构建时把前端静态导出运行时不再依赖 Node.js资源占用更低。常见问题速查表现象原因动作reflex: command not found在虚拟环境外直接执行了命令统一使用uv run reflex ...形式Windows 提示 bun.exe 缺 DLL缺少 Visual C 运行时组件安装 Visual C 2015 Redistributable3000 端口被占用其他程序占用了默认前端端口开发模式会自动切换端口固定端口则改rxconfig.py的frontend_port页面空白或一直加载前端编译失败或前后端未连上用uv run reflex run --loglevel debug看日志并查浏览器 F12 网络请求改了代码页面不变改到了.web目录下的编译产物只改my_app/my_app.py等源码文件.web不要手动编辑下一步跑通之后你可以朝两个方向继续打开 docs/getting_started/basics.md学组件、状态和事件三个核心概念把空白页改成你自己的交互页面修改my_app/my_app.py试着加一个输入框和按钮验证热更新再逐步加入rx.State管理数据【免费下载链接】reflex️ Web apps in pure Python 项目地址: https://gitcode.com/GitHub_Trending/re/reflex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
