Debian Fortran如何进行版本控制

Debian Fortran项目的版本控制实践

一 版本控制的核心做法

• 使用Git进行源码版本管理，配合GitHub/Gitee/GitLab进行远程协作与备份。
• 在仓库根目录初始化：git init；或克隆现有仓库：git clone 。
• 常用工作流：git add <文件/目录>；git commit -m “描述”；git push；git pull；git status 查看状态；必要时创建与切换分支：git checkout -b feature/x。
• 建议同时维护：.gitignore（忽略编译产物与编辑器文件）、README（构建与依赖说明）、LICENSE（开源协议）。

二 与构建系统配合的要点

• 多文件/多模块项目优先使用Makefile或**Fortran Package Manager（FPM）**管理构建，避免把编译产物（如可执行文件、.o、.mod）纳入版本控制。
• 示例 Makefile（要点）
  • FC = gfortran；FFLAGS = -O2 -Wall
  • SRCS = main.f90 mod1.f90；OBJS = $(SRCS:.f90=.o)
  • TARGET = app
  • $(TARGET): $(OBJS) 和 %.o: %.f90 规则；提供 make、make clean
• 使用 FPM 的典型流程
  • 安装 FPM（可从发布页下载二进制，放入 PATH）
  • fpm new my_app；cd my_app
  • fpm build；fpm run（开发期一键构建运行）
• 第三方库（如BLAS/LAPACK/OpenMP）通过系统包管理器安装并在构建脚本中声明依赖，源码仓库内不存放这些库的源码。

三 编译器与标准的版本管理

• 在 Debian 上通过安装不同版本的gfortran管理“编译器版本”，并通过update-alternatives切换默认版本，保证构建可复现。
  • 查看/安装：gfortran --version；sudo apt install gfortran-<版本号>
  • 切换默认：sudo update-alternatives --config gfortran
• 在代码与文档中显式标注所需Fortran 标准（如F2003/F2008/F2018）与关键编译选项（如 -O2、-fopenmp），便于他人复现实验与 CI 一致性。
• 若需并行计算，安装libopenmp-dev并在构建脚本中启用 OpenMP 标志。

四 打包发布与变更记录

• 使用Debian 打包将程序与版本一起发布：安装打包工具（如 dpkg-dev、debhelper），在 debian/ 目录编写控制文件（control）、变更记录（changelog）、安装脚本（install）等，然后构建 .deb 包。
• 变更记录（changelog）用于记录每次发布的版本号与变更内容，与 Git 提交历史相辅相成，便于追溯与发布合规。

五 推荐目录与文件结构示例

• 建议结构
  • src/：源码（.f90/.F90）
  • include/ 或 mod/：模块文件（.mod，由构建系统生成，不纳入 Git）
  • tests/：单元测试
  • Makefile 或 fpm.toml
  • README.md、LICENSE、.gitignore
  • .github/workflows/：CI 配置（如 GitHub Actions）
• 说明
  • .gitignore 示例：.o、.mod、.so、.a、app、build/、.vscode/、.idea/
  • CI 中固定编译器版本与标准（如矩阵策略设置 gfortran-10/11 与 -std=f2008），确保跨环境一致性。