企业官网建设流程全解析

OpenFootManager（Openfoot Manager）是一款免费的开源足球经理模拟游戏，基于 Rust + Tauri 构建游戏引擎，用 React + TypeScript 打造桌面端界面。想为这款开源项目贡献代码？这篇完整指南将带你快速完成Rust + React 开发环境搭建，学会运行后端cargo test与前端 Vitest 测试，并按 Fork & Pull 流程顺利提交你的第一个PR——零基础也能看懂。

🎯 先了解项目：OpenFootManager 的贡献路径

OpenFootManager 由一位足球爱好者发起，目标是打造一款完全开源、不受商业版权限制的 Football Manager 替代品。它的技术栈非常现代：

除了写代码，项目也欢迎其他形式的贡献：报告 Bug、提出功能建议、完善文档、翻译、制作内容等，都可以参考 CONTRIBUTING.md。而本文聚焦于最传统的贡献方式——提交代码。

🛠️ 第一步：搭建 Rust + React 开发环境

安装三个核心依赖

开发本项目的官方指南要求安装以下工具（详见 README.md）：

1. Rust：后端语言，可通过rustup安装
2. Node.js v18+：前端构建工具链
3. Tauri 平台依赖：按你的操作系统安装 Tauri 官方指南中列出的桌面开发前置依赖（Linux 常见为 WebKit 与 GTK 相关开发包）

克隆仓库并安装前端依赖

git clone https://gitcode.com/gh_mirrors/op/openfootmanager cd openfootmanager npm install

npm install会安装 package.json 中声明的全部前端依赖，包括 React 19、Vite 7、Vitest 4 等。

一键启动开发版

npm run tauri dev

这条命令会同时启动 Vite 开发服务器（固定端口 1420，配置见 vite.config.ts）和 Tauri 桌面应用。第一次编译 Rust 代码稍慢，属正常现象。看到游戏主菜单出现，说明开发环境搭建成功 ✅

🗺️ 第二步：读懂代码结构再动手

OpenFootManager 的后端拆分为 4 个职责清晰的 Rust crate（见 src-tauri/Cargo.toml 中的 workspace 定义），全部位于 src-tauri/crates/ 目录：

依赖边界非常明确：engine刻意不依赖domain，用turn.rs做类型桥接，这样引擎可以独立测试。前端则全部在 src/ 目录，页面路由见 src/App.tsx，UI 组件按components/下的 match、dashboard、menu 等模块组织。

完整的架构说明、IPC 命令表与数据流图，务必通读 docs/ARCHITECTURE.md；想了解游戏玩法机制可以搭配 docs/GETTING_STARTED.md 一起看。

✅ 第三步：提交 PR 前必须跑通测试

项目对测试有硬性要求：新增后端功能必须附带测试。

Rust 后端测试

按社区惯例，单元测试写在同一文件的#[cfg(test)]模块中。提交前在项目根目录执行：

cd src-tauri cargo test

这条命令会运行 workspace 内全部 4 个 crate 的测试。此外别忘了两条代码质量命令：

• cargo fmt：格式化 Rust 代码
• cargo clippy：静态检查，所有警告必须在提交 PR 前处理干净

React 前端测试

前端使用 Vitest + Testing Library（jsdom 环境），测试文件与源码同目录、以.test.ts(x)命名，如 src/store/gameStore.test.ts。运行方式：

npm test # 单次运行全部测试 npm run test:watch # 开发时监听模式

🚀 第四步：Fork & Pull，提交你的 PR

OpenFootManager 采用标准的Fork & Pull协作流程：

1. Fork仓库到你的账户
2. 拉取项目的develop分支最新代码，在其基础上创建feature 分支
3. 完成开发、格式化、测试
4. 向develop分支发起Pull Request，在描述中写清楚改动内容，并关联相关的Issue编号
5. 如果你的功能没有对应 Issue，请先开一个 Issue 描述需求，再在 PR 中引用它

提交前自查清单

📝 写在最后

从克隆仓库到第一个 PR 被合并，OpenFootManager 为贡献者准备了清晰的代码边界、完整的测试基座和详尽的架构文档。建议新人从domaincrate 的数据模型或小界面组件入手，跑通cargo test和npm test后，你离第一个 PR 只差一次 Fork。祝你的第一笔代码顺利进入develop分支！🏆