Debian下Fortran代码的版本控制实践

一 环境准备

• 安装版本控制工具与编译器：在 Debian 上执行以下命令安装 Git 与 gfortran，为后续提交与本地构建提供基础环境。
  • sudo apt update
  • sudo apt install -y git gfortran
  • 验证安装：git --version、gfortran --version
• 可选：安装常用构建工具（便于在提交前后进行本地构建与回归测试）
  • Makefile 或 Fortran 包管理器 FPM（fpm）：简化多文件与依赖管理，适合团队协作与持续集成。

二 初始化仓库与基本流程

• 初始化本地仓库
  • cd /path/to/fortran/project
  • git init
• 配置提交者信息（首次使用建议全局配置）
  • git config --global user.name “Your Name”
  • git config --global user.email “your_email@example.com”
• 首次提交与远程托管
  • git add .
  • git commit -m “Initial commit: project skeleton”
  • 关联远程仓库（GitHub/GitLab 等）
    • git remote add origin
    • git branch -M main
    • git push -u origin main
• 常用日常操作
  • 状态与日志：git status、git log
  • 分支开发：git checkout -b feature/x、git checkout main、git merge feature/x
  • 同步远程：git pull --rebase、git push

三 适用于Fortran的.gitignore

• 建议将编译产物与依赖缓存纳入忽略，保持仓库清洁、减小体积。
• 示例 .gitignore（可按需增删）

  • 编译产物

    • *.o
    • *.mod
    • *.a
    • *.so
    • *.x
    • *.out
    • /build/

  • 编辑器与系统文件

    • .vscode/
    • .idea/
    • *.swp
    • *~

  • 依赖管理（使用 FPM 时）

    • fpm.toml
    • /fpm_build/

  • 可选：测试与覆盖率

    • /tests/results/
    • *.gcda
    • *.gcno

四 协作与持续集成

• 分支策略建议
  • 使用 main 作为稳定分支；功能与修复分别在 feature/、bugfix/ 分支开发，通过 Pull Request/Merge Request 合并，合并前要求通过构建与测试。
• 在 GitHub Actions 配置简易 CI（示例）
  • 在 .github/workflows/fortran-ci.yml 中：
    • 触发事件：on: [push, pull_request]
    • 作业环境：runs-on: ubuntu-latest
    • 步骤：
      • actions/checkout@v4
      • 安装编译器：sudo apt update && sudo apt install -y gfortran
      • 构建与运行（示例单文件；多文件或 FPM 项目请替换为对应命令）
        • gfortran hello.f90 -o hello && ./hello
  • 说明：该示例适用于快速验证环境可用性与基本可运行性；复杂项目建议加入单元测试、静态检查与多编译器矩阵。

五 与构建系统配合的最佳实践

• 使用 Makefile 或 FPM 管理多文件与模块依赖，提交前在本地执行构建与测试，确保提交可构建、可运行。
  • Makefile 示例要点：定义 FC=gfortran、FFLAGS=-Wall -O2，按目标文件链接，提供 clean 目标。
  • FPM 示例要点：fpm new 创建项目，使用 fpm build、fpm run、fpm test 完成构建、运行与测试，减少手工命令差异带来的构建不一致。
• 提交粒度与信息规范
  • 小步提交、频繁提交；提交信息写明“为什么改”和“改了什么”，便于回溯与代码审查。
• 本地与远程分支同步
  • 推送前先同步上游变更（git pull --rebase），减少非必要合并提交；合并通过 PR/MR 完成，保留审查记录。