Reflex 新手指南5 条命令跑通第一个纯 Python Web 应用【免费下载链接】reflex️ Web apps in pure Python 项目地址: https://gitcode.com/GitHub_Trending/re/reflexReflex 是一个用纯 Python 构建全栈 Web 应用的框架前端和后端都写.py文件不需要写 JavaScript。它在本地把你的 Python 组件编译成 React 前端开发时保存代码即热重载。读完这篇指南你会得到一个跑在http://localhost:3000的空白应用并清楚哪些文件能改、哪些文件不能碰。环境要求只有一条Python 3.10安装细节可查 docs/getting_started/installation.md。黄金路径从零到本地运行前置条件是装好包管理器 uvmacOS/Linux 用官方文档里的一行安装脚本Windows 用 PowerShell 命令均见 docs/getting_started/installation.md。然后执行mkdir my_app cd my_app uv init uv add reflex uv run reflex initreflex init会问你要哪个模板(0) 空白应用(1) AI builder。第一次直接选 0官方文档后续内容都基于它。生成后my_app/my_app.py是应用入口rxconfig.py是配置文件。启动开发服务器uv run reflex run浏览器打开http://localhost:3000就能看到默认页面。此后修改代码并保存浏览器几秒内自动刷新不用重启进程。项目结构哪些文件别碰reflex init生成的目录不复杂完整说明见 docs/getting_started/project-structure.md.venv/是 uv 建的虚拟环境依赖和系统 Python 隔离。.web/是编译产物目录 ⚠️ 不要编辑、不要提交每个页面会编译出对应的.js排查编译问题时倒是可以看看。assets/放图片、字体等静态资源组件里直接按路径引用。pyproject.toml记录依赖uv.lock锁定解析后的版本建议提交给团队保证一致。日常开发你只需要碰应用 py 文件这一个地方。初始化报错速查现象原因处理办法reflex命令找不到没在虚拟环境里执行或 uv 不在 PATH命令一律加uv run前缀或先激活.venv初始化卡在选择模板首次 init 需要选模板选 (0) 空白应用即可Windows 报 missing a DLL required to run bun.exeBun 依赖 VC 运行时安装 Microsoft Visual C 2015 运行库后重试提示端口 3000 被占用其他服务占了前端默认端口后端默认 8000找到占用进程释放或在rxconfig.py里改为空闲端口页面空白、无响应编译或前端依赖安装失败加--loglevel debug重跑看日志检查.web/pages/下是否生成了.js改了代码不刷新误改了生成目录只改应用源码.web/一律不动生产部署Caddy 反代容器化方案要上线的话仓库自带 4 套 Docker 示例见 docker-example/README.md新手最实用的是production-compose构建时把前端静态导出运行时只跑后端加 Caddy 反向代理不需要 Node.js内存占用更小。在 docker-example/production-compose/ 目录下两条命令DOMAINexample.com docker compose build DOMAINexample.com docker compose upDOMAIN填访问域名不带协议前缀不填则默认给 localhost 自动申请 TLS 证书签发过程可能花几分钟。如果应用需要更高并发追加-f compose.prod.yaml即可带起 Postgres 和 Redis、让后端多 worker 运行只开单端口的场景可以看simple-one-port示例。验收三条自检确认跑通执行uv run reflex run后打开http://localhost:3000页面显示默认欢迎内容而不是空白或 404说明前端跑起来了。改掉my_app/my_app.py里的页面标题并保存几秒内浏览器标题自己变化说明热重载生效——这是 Reflex 开发体验的核心。用uv run reflex --version确认装的版本再对照当前版本文档查 API需要断点调试时按 DEBUGGING.md 在 VSCode 里以模块方式启动或者加CI1做无头运行验证。三条都通过你的第一个纯 Python Web 应用就算真正跑通了接下来从改页面标题开始往真实功能上迭代即可。【免费下载链接】reflex️ Web apps in pure Python 项目地址: https://gitcode.com/GitHub_Trending/re/reflex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
