CentOS 上 Fortran 项目的协作开发实践
一 环境与工具链
- 安装基础工具与编译器：建议一次性安装开发组通用工具链，包含gcc、gfortran、make、git、cmake，便于统一构建与版本管理。
- 命令示例：sudo yum groupinstall “Development Tools” -y && sudo yum install -y gcc-gfortran make git cmake
- 可选：安装Intel Fortran（ifort/ifx）用于性能关键路径，或统一使用 gfortran 减少环境差异。
- 统一编辑器与语言服务：安装VS Code与fortran-language-server（fortls），为多人协作提供一致的语法高亮、跳转、补全与诊断。
- 命令示例：pip3 install fortran-language-server
- 建议做法：在仓库根目录提供环境校验脚本（如 scripts/check_env.sh），快速验证编译器版本、库路径与工具可用性，减少“在我机器上能跑”的问题。
二 版本控制与分支策略
- 初始化与基础流程：使用Git进行协作，统一提交规范（如约定式提交）、.gitignore（忽略***.o、.mod、.a、*.so、可执行文件**等），并配置用户名与邮箱。
- 命令示例：git config --global user.name “Your Name”；git config --global user.email “you@example.com”
- 分支模型：采用Git Flow或GitHub Flow均可。推荐特性分支开发、保护main/develop分支、通过Pull Request/Merge Request评审后合并；必要时使用git rebase保持提交历史整洁。
- 代码规范与质量：在协作前约定代码风格、接口稳定性与向后兼容策略；使用pre-commit钩子运行格式化与静态检查，降低评审负担。
三 构建与依赖管理
- 统一构建方式：
- 小型/模块化项目优先使用FPM（Fortran Package Manager），通过 fpm.toml 声明依赖、自动处理模块与构建，降低新人上手成本。
- 中大型或已有工程使用CMake或Makefile；CMake 便于跨平台与测试集成，Makefile 简单直观、改造成本低。
- 依赖库管理：
- 系统库（如BLAS/LAPACK）优先用yum/dnf安装；若需特定版本或内部库，统一放置于**/opt/your-org等目录，并在构建脚本中通过-I/-L/-l**显式指定头文件与库路径。
- 第三方库（如NetCDF/HDF5）建议采用“编译安装到统一前缀 + 环境变量导出”的方式，保证开发与CI环境一致。
- 示例命令：
- gfortran program.f90 -o program -L/opt/your-org/lib -lname
- 环境变量示例：export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH（写入 .bashrc 或模块文件）
- 建议做法：在仓库中固化构建脚本（如fpm.toml / CMakeLists.txt / Makefile）、依赖清单与版本号，避免“本地路径”与“个人偏好”进入仓库。
四 本地开发到CI与代码评审
- 本地到远程协作：开发者在特性分支完成编码与自测后，推送至远端仓库并创建Pull Request；通过GitHub/GitLab CI执行构建、单元测试与静态检查，评审通过后再合并。
- 持续集成要点：
- 使用多编译器矩阵（如 gfortran 不同版本）与不同优化级别进行构建，及早发现可移植性问题。
- 运行基础回归测试与性能基准（可选），确保改动不引入功能退化与性能回退。
- 调试与性能分析：
- 调试使用gdb；性能分析使用gprof/perf定位瓶颈，必要时结合编译器**-O2/-O3优化选项与OpenMP/MPI**并行策略进行验证。
五 一键模板与落地清单
- 仓库骨架建议（示例）：
- fpm.toml / CMakeLists.txt / Makefile（三选一或并存）
- src/、test/、examples/、scripts/（check_env.sh、ci.yml）、.gitignore、README.md、LICENSE
- 开发者上手命令清单（示例）：
- 环境：sudo yum groupinstall “Development Tools” -y && sudo yum install -y gcc-gfortran make git cmake
- 语言服务：pip3 install fortran-language-server
- 构建与测试：fpm build / fpm test 或 make / ctest
- 运行示例：./build/app 或 fpm run --example hello
- 团队协作要点：统一工具链与路径、固化构建脚本与环境变量、强制PR评审与CI通过、在仓库根目录维护CONTRIBUTING.md与CHANGELOG.md，明确提交流程、版本策略与回滚机制。
