CentOS C++项目的版本控制配置指南

在CentOS上搭建C++开发环境，版本控制是绕不开的一环。一套清晰、规范的配置，不仅能让你和团队协作顺畅，更能为项目的长期维护打下坚实基础。下面这份指南，就带你从零开始，一步步完成配置。

一 环境准备与基础配置

工欲善其事，必先利其器。动手之前，先把必要的工具和环境准备好。

• 安装开发工具与版本控制工具：
  • 安装编译与调试工具： 这是C++开发的基石。直接在终端执行：sudo yum groupinstall “Development Tools”，然后安装C++编译器与调试器：sudo yum install gcc-c++ gdb。
  • 安装 Git： 版本控制的核心。命令很简单：sudo yum install git。
• 配置 Git 全局身份（对所有仓库生效）：
  • 设置用户名与邮箱： 这是你每次提交的“签名”，务必准确。运行：git config --global user.name “Your Name” 和 git config --global user.email “your.email@example.com”。
  • 可选：设置默认编辑器： 如果你习惯用vim编辑提交信息，可以设置：git config --global core.editor vim。
• 生成 SSH 密钥用于免密访问远端仓库（如 GitLab/Gitee/GitHub）：
  • 生成密钥： 执行 ssh-keygen -t rsa -C “youremail@mail.com”，一路回车使用默认设置即可。
  • 添加公钥： 关键一步。用cat命令查看公钥内容：cat ~/.ssh/id_rsa.pub，然后将输出的全部文本，复制粘贴到你所用Git平台（GitLab、Gitee或GitHub）账户设置里的SSH Keys页面。

二 本地仓库初始化与标准配置

基础打牢后，就可以开始初始化你的项目仓库了。这里的每一步，都关乎日后协作的便利性。

• 初始化仓库与首次提交：
  • 进入你的项目根目录，执行 git init 初始化一个本地Git仓库。
  • 将当前所有文件添加到暂存区：git add .。
  • 进行第一次提交，留下记录：git commit -m “Initial commit”。
• 连接远端并推送：
  • 关联远端： 你需要将本地仓库与远程服务器上的仓库关联起来。根据你克隆仓库时使用的协议，二选一即可：
    • HTTPS： git remote add origin https://your-domain/namespace/repo.git
    • SSH： git remote add origin git@your-domain:namespace/repo.git （如果已配置SSH密钥，推荐此方式）
  • 推送： 执行 git push -u origin master（如果远端默认分支是main，则改为main），将本地提交推送到远程。
• 使用 .gitignore 过滤不需要的文件（C++ 常用规则示例）：

  这是保持仓库整洁的关键。在项目根目录创建.gitignore文件，加入以下规则，可以有效避免将编译产物、IDE配置等无关文件提交进去。

  # 编译产物
  *.o
  *.obj
  *.so
  *.dll
  *.dylib
  *.a
  *.lib
  *.exe
  *.out
  
  # 预编译头
  *.gch
  *.pch
  
  # 构建目录
  [Bb]in/
  [Oo]bj/
  Debug/
  Release/
  x64/
  x86/
  build/
  CMakeFiles/
  CMakeCache.txt
  cmake_install.cmake
  Makefile
  CTestTestfile.cmake
  
  # 日志与临时
  *.log
  *.tlog
  *.idb
  *.ilk
  *.tmp
  *.lastbuildstate
  
  # IDE/编辑器
  .vs/*
  *.suo
  *.user
  *.sdf
  *.ipch
  *.VC.db
  .idea/
  *.swp
  *.swo
  Thumbs.db
  Desktop.ini

  规则要点： 以 # 开头为注释；以 / 结尾仅匹配目录；! 表示取反例外；/ 开头仅匹配仓库根目录；* 需转义；** 双星号匹配多级目录。

• 若已误提交需忽略的文件，先将其从索引移除再提交：
  • 如果不小心把应该忽略的文件提交了，可以补救：git rm -r --cached 路径/到/文件或目录。
  • 然后重新添加并提交更改：git add . && git commit -m “Remove ignored files from index” && git push。

三 自建 Git 服务器与权限管理

对于内部项目或小团队，自建Git服务器能提供更高的灵活性和控制权。这里介绍两种主流方案。

• 基于 SSH 的最小可用方案（适合小团队）：
  • 创建专用用户： 在服务器上执行 adduser git 并设置密码 passwd git。
  • 配置 authorized_keys：
    • 切换到git用户：su git。
    • 创建SSH目录和授权文件：mkdir -p ~/.ssh && touch ~/.ssh/authorized_keys。
    • 设置严格权限：chmod 700 ~/.ssh && chmod 600 ~/.ssh/authorized_keys。
    • 将需要访问的团队成员的公钥，逐行追加到 authorized_keys 文件中。
  • 创建裸仓库： 执行 git init --bare /home/git/project.git，创建一个没有工作区的纯仓库。
  • 客户端克隆与推送： 团队成员在本地即可通过 git clone git@your-server:project.git 进行克隆和后续推送。
  • 安全加固（可选）： 限制git用户只能执行Git操作，禁止其登录shell。
    • 创建目录：mkdir /home/git/git-shell-commands。
    • 修改 /etc/passwd 文件，找到git用户那一行，将其末尾的shell改为 /bin/git-shell。
• 团队权限自动化（中大型团队推荐 gitolite）：

  当团队规模扩大，基于SSH密钥的简单授权会变得难以管理。这时，Gitolite是更专业的选择。

  • 安装与初始化（以 git 用户执行）：
    • 安装Perl依赖：yum install ‘perl(Data::Dumper)’。
    • 克隆并安装：git clone https://github.com/sitaramc/gitolite && mkdir -p ~/bin && ./gitolite/install -to ~/bin。
    • 导入管理员公钥并初始化：~/bin/gitolite setup -pk ~/YourName.pub。
  • 通过管理仓库配置： 初始化后会生成一个名为 gitolite-admin 的特殊仓库。管理员克隆此仓库，在其中的配置文件中定义仓库列表、用户公钥以及精细的读写权限（如RW、RW+、分支保护策略等），推送后配置自动生效，极大地简化了权限管理。

四 与构建系统及 IDE 的协同

版本控制不是孤立的，它需要与你的开发工具链完美配合，才能提升整体效率。

• 使用 CMake 时的推荐做法：
  • 在仓库根目录维护主 CMakeLists.txt 文件。构建时，务必采用“外部构建”方式，即在项目根目录新建一个 build/ 目录，并在其中运行cmake。这样，所有编译生成的文件都会集中在build/里，源码树保持干净，这个目录也正好可以被.gitignore规则忽略。
  • 为了获得更好的IDE支持（如代码跳转、静态分析），可以生成编译数据库文件 compile_commands.json。如果使用xmake，可以运行 xmake project -k compile_commands；如果使用CMake，则在配置时加上 -DCMAKE_EXPORT_COMPILE_COMMANDS=ON 选项。生成后，可以将其软链接或复制到 .vscode/ 目录下，供VS Code等编辑器使用。
• 多平台换行符与属性管理：

  跨平台协作时，换行符（Windows的CRLF和Linux/macOS的LF）是个恼人的问题。通过.gitattributes文件可以一劳永逸地解决。

  在仓库根目录创建该文件，内容示例如下：

  # 统一文本为 LF，Windows 自动转 CRLF
  * text=auto eol=lf
  
  # 明确工程/脚本类型
  *.sln text eol=lf
  *.vcxproj text eol=lf
  *.vcxproj.filters text eol=lf
  *.sh text eol=lf
  *.bat text eol=crlf
  
  # 明确二进制文件
  *.png binary
  *.jpg binary
  *.jpeg binary
  *.gif binary
  *.ico binary
  *.pdf binary
  *.zip binary
  *.exe binary
  *.dll binary
  *.so binary
  *.lib binary
  *.pdb binary

  如果仓库中已有的文件换行符混乱，可以使用命令 git add --renormalize . 进行一次性的规范化处理，之后再提交即可。