xfy
d11385e3ee
Testing 章节补充：fullstack 项目必须同时验证 server 与 wasm32 两个 target，给出 wasm 编译命令；说明 dx check 不等于完整 cargo wasm build，会漏掉 borrow/move 错误；列出三类常见 target-mismatch 陷阱 （cfg 不可见、unused_mut 误删、函数内 use 作用域）。 新增 Pitfall Log 章节，记录本次重构踩过的四个坑： - 持有资源的 custom hook（use_hook+use_effect+use_drop）里 FnMut 闭包 move FnOnce 参数的 E0507/E0310，用 Option::take 模式解决； - 单 target 验证的危害（只跑 cargo build --all-features 会漏 wasm 错误）； - 仅 wasm 需要的 mut 绑定用 cfg_attr 压制非 wasm 的 unused_mut； - 往 utils 模块搬函数前先查目标模块的 feature gate（text.rs 是 server-only 且依赖 regex，前端可达函数不能进）。
Yggdrasil
基于 Dioxus 0.7 的全栈博客系统，Rust 单一代码库同时编译为 WASM 前端和原生服务端。
技术栈
- 框架: Dioxus 0.7 (fullstack)
- 数据库: PostgreSQL + tokio-postgres
- 样式: Tailwind CSS v4
- 密码: Argon2
- 会话: UUID token + cookie
功能
- 邮箱注册 / 登录（单管理员模式，首次注册后关闭）
- 会话管理与自动过期清理
- 暗色 / 亮色主题切换
- 后台文章撰写（Tiptap Markdown 编辑器）
- 文章归档与标签浏览
开发
依赖 Rust 1.95+、wasm32 目标、dx CLI、tailwindcss CLI v4 和 PostgreSQL。
# 配置数据库
DATABASE_URL=postgres://postgres:postgres@localhost:5432/yggdrasil
# 运行迁移（自动创建数据库并按顺序执行 migrations/ 下所有 SQL）
./migrate.sh
# 启动开发服务器
make dev
构建
make build
生产部署
生产环境必须前置反向代理（nginx/Caddy）做 TLS 终结，并设置 APP_BASE_URL、
COOKIE_SECURE=true、TRUSTED_PROXY_COUNT=1。详见 部署指南。