Ubuntu下Fortran代码的版本控制实操指南

一 安装与基础配置

• 安装 Git：在终端执行以下命令，完成后用git --version验证安装是否成功。
  • sudo apt update
  • sudo apt install git
  • git --version
• 配置全局身份（每次提交都会附带此信息）：
  • git config --global user.name “Your Name”
  • git config --global user.email “your.email@example.com”
• 建议同时配置默认文本编辑器（可选）：
  • git config --global core.editor “vim” # 或 nano、code 等

二 本地仓库与首次提交

• 进入项目目录并初始化仓库：
  • cd /path/to/your/fortran/project
  • git init
• 将 Fortran 源码纳入版本控制（常用扩展名：.f90、.f08、.f、.for、.f77）：
  • git add . # 添加当前目录全部文件

  • 或仅添加部分文件：git add main.f90 utils.f90

• 提交更改：
  • git commit -m “Initial commit of Fortran project”
• 常用查看与撤销：
  • git status # 查看工作区与暂存区状态
  • git log # 查看提交历史
  • git checkout – file.f90 # 丢弃工作区对 file.f90 的修改
  • git reset HEAD file.f90 # 将已暂存的 file.f90 撤回到工作区

三 远程协作与分支管理

• 关联远程仓库（GitHub/GitLab 等）并推送：
  • 在托管平台创建空仓库，复制仓库 URL（HTTPS 或 SSH）。
  • git remote add origin
  • 推送本地分支并建立上游跟踪（默认分支可能是 main 或 master，按实际替换）：
    • git push -u origin main

    • 或：git push -u origin master

• 克隆现有仓库：
  • git clone
• 同步上游变更：
  • git pull origin main # 或 master
• 分支工作流（功能/修复分支）：
  • 创建并切换到新分支：git checkout -b feature/x
  • 完成后合并回主分支：git checkout main & & git merge feature/x
  • 删除已合并分支：git branch -d feature/x

四 Fortran项目的.gitignore建议

• 编译与依赖产物、日志与缓存、编辑器/系统文件等通常无需纳入版本控制，建议加入**.gitignore**：
  • 示例（可按需增删）：

    • 编译与依赖

    • *.o *.mod *.a *.so *.dll
    • build/ bin/ obj/ lib/

    • 测试与结果

    • *.log *.out *.vtk *.h5

    • IDE/编辑器

    • .vscode/ .idea/ *.swp *.swo

    • OS

    • .DS_Store
• 快速初始化 .gitignore：curl -o .gitignore https://www.toptal.com/developers/gitignore

五 协作与持续集成建议

• 提交规范：每次提交聚焦一个逻辑变更，信息简明清晰（如“Add matrix multiply routine”）。
• 分支策略：以main/mainline为稳定分支，功能与修复在feature/、bugfix/ 分支开发后合并。
• 标签管理：对发布版本打标签，便于回溯与发布说明生成。
  • git tag -a v1.0 -m “Release v1.0”
  • git push origin v1.0
• 持续集成：结合 GitHub Actions/GitLab CI 自动执行构建与测试（如编译、运行单元测试、检查代码风格），提升代码质量与交付效率。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！