C++程序在Ubuntu上如何进行版本控制

在 Ubuntu 上对 C++ 项目进行版本控制

一 安装与初始化 Git

• 安装 Git：sudo apt update && sudo apt install git
• 配置全局身份：git config --global user.name “Your Name”；git config --global user.email “your.email@example.com”
• 初始化仓库：在项目根目录执行：git init
• 常用基本操作：
  • 查看状态：git status
  • 添加文件：git add .
  • 提交更改：git commit -m “Initial commit”
  • 查看历史：git log
• 远程仓库协作：
  • 克隆：git clone
  • 添加远程：git remote add origin
  • 推送：git push -u origin main
  • 拉取：git pull origin main
• 分支管理：git branch feature/x；git checkout feature/x；git checkout main；git merge feature/x。

二 典型工作流与常用命令

• 功能开发：从 main 创建分支（git branch feature/x；git checkout feature/x），完成后切回 main 并合并（git checkout main；git merge feature/x）
• 保持同步：定期 git pull origin main；必要时使用 git rebase 整理提交历史
• 冲突处理：合并冲突时手动编辑冲突文件，保存后执行 git add 与 git commit 完成合并
• 提交规范：每次提交保持原子性，信息清晰；必要时使用 git stash 暂存未提交改动，拉取后再恢复（git stash；git pull；git stash pop）。

三 C++ 项目的 .gitignore 建议

• 构建产物与依赖缓存：
  • build/、dist/
  • .o、.a、.so、.dll、*.dylib
  • CMakeCache.txt、CMakeFiles/、Makefile、cmake_install.cmake
• 编辑器与系统文件：
  • .vscode/、.idea/
  • .swp、.swo
  • .DS_Store（macOS）、Thumbs.db（Windows）
• 语言与环境特定：
  • .env、.venv/、venv/
  • compile_commands.json（可选：若由工具自动生成，可纳入版本控制以便 IDE 索引）

四 与构建系统和 IDE 配合

• 使用 CMake 管理跨平台构建：sudo apt-get install build-essential gdb cmake；在 VS Code 中安装 C/C++、CMake Tools 等扩展，可直接进行配置、构建与调试
• 使用 Makefile 的小型项目：保持简洁可重复；提交前确保能在干净环境 make 成功。

五 版本发布与协作规范

• 语义化版本与标签：按 MAJOR.MINOR.PATCH 打标签，例如：git tag v1.2.3；推送标签：git push origin v1.2.3
• 分支策略：长期维护 main，功能与修复使用短期分支，合并前进行代码审查（如 GitHub/GitLab PR/MR）
• 持续集成：配置 CI（如 GitHub Actions、Jenkins）自动构建与测试，保障每次提交与标签的可发布性
• 代码质量：开启编译器警告（如 -Wall -Wextra）、使用 Cppcheck/Clang Static Analyzer 做静态分析，并配套单元测试与自动化测试。