Debian如何进行Fortran代码版本控制

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

四协作与持续集成

分支策略建议
- 使用 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 完成，保留审查记录。

编译产物