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

在 Debian 上进行 Fortran 代码版本控制

一 安装与初始化

• 安装 Git：sudo apt update && sudo apt install -y git
• 配置全局身份：git config --global user.name “Your Name”；git config --global user.email “you@example.com”
• 新建或克隆仓库：
  • 新建：在项目目录执行 git init
  • 克隆：git clone
• 基本流程：git add ；git commit -m “msg”；git status；git log

二 推荐的 .gitignore 与项目结构

• 建议的 .gitignore（Fortran 项目常用）

# 构建产物
*.o
*.mod
*.so
*.a
*.x
*.out
/build
/dist

# 编辑器与系统文件
*.swp
*.swo
*~

# IDE
.vscode/
.idea/
*.sublime-*

# 依赖与缓存
**/__pycache__/
node_modules/

# 可选：Intel/PGI 编译器产物
*.dSYM

• 简洁项目结构示例

my_fortran/
├── src/            # .f90/.F90 源文件
├── include/        # .inc/.h（如有）
├── lib/            # 第三方库（子模块或已安装）
├── tests/          # 测试程序
├── fpm.toml        # 如使用 fpm
├── Makefile        # 如使用 make
└── README.md

三 与构建系统协同

• 使用 fpm（Fortran Package Manager）
  • 安装：wget https://github.com/fortran-lang/fpm/releases/download/v0.9.0/fpm-0.9.0-linux-x86_64 -O /usr/local/bin/fpm && chmod +x /usr/local/bin/fpm
  • 初始化与运行：fpm new my_project；cd my_project；fpm run；fpm test
  • 建议将 fpm.toml 纳入版本控制，便于协作与复现构建
• 使用 Make
  • 典型 Makefile（示例）

    FC = gfortran
    FFLAGS = -O2 -Wall
    SRCS = main.f90 mod1.f90
    OBJS = $(SRCS:.f90=.o)
    TARGET = app
    
    $(TARGET): $(OBJS)
    	$(FC) $(FFLAGS) -o $@ $^
    
    %.o: %.f90
    	$(FC) $(FFLAGS) -c $< -o $@
    
    clean:
    	rm -f $(OBJS) $(TARGET)
    

  • 建议将 Makefile 纳入版本控制，.o/.mod 等由 .gitignore 忽略

四 协作与发布流程

• 分支策略：main 稳定分支；feature/* 开发分支；bugfix/* 修复分支
  • 创建与切换：git switch -c feature/x 或 git checkout -b feature/x
  • 合并回 main：git switch main；git merge --no-ff feature/x
• 远程仓库：git remote add origin ；git push -u origin main
• 标签与发布：git tag -a v1.0.0 -m “Release 1.0.0”；git push --tags
• 常用协作命令：git pull --rebase；git stash push -m “WIP”；git stash pop

五 调试与持续集成建议

• 调试信息：编译时加入 -g（如 gfortran -g …），便于使用 gdb/lldb 调试；内存检查可用 Valgrind
• 持续集成示例（GitHub Actions，适用于 fpm 项目）
  • .github/workflows/ci.yml

    name: CI
    on: [push, pull_request]
    jobs:
      build:
        runs-on: ubuntu-latest
        steps:
          - uses: actions/checkout@v4
          - name: Install fpm
            run: |
              wget https://github.com/fortran-lang/fpm/releases/download/v0.9.0/fpm-0.9.0-linux-x86_64 -O /usr/local/bin/fpm
              chmod +x /usr/local/bin/fpm
          - name: Build and test
            run: |
              fpm build --profile release
              fpm test --profile release
    

• 编辑器与语言支持：使用 VS Code 安装 Modern Fortran 插件，获得语法高亮、跳转与格式化支持