GitHub Action构建CMake项目后git status显示当前目录未追踪的原因与解决

原因分析 #

这种情况本质是CMake构建过程中在源码根目录下意外创建了一个名为.的文件或符号链接——Linux系统中.本是当前目录的指代，但这里是作为一个实际的文件条目存在，被git识别为未追踪内容。常见触发场景：

• CMake脚本配置错误，将输出路径设为.而非指定的子目录
• 自定义构建命令（如add_custom_command）参数写错，生成了名为.的文件
• 第三方依赖或构建工具的bug，导致异常文件生成

解决方法 #

排查修复CMake脚本 #

检查CMakeLists.txt及所有关联脚本：

• 确认所有CMAKE_BINARY_DIR、INSTALL_PREFIX等路径配置，避免指向源码根目录
• 检查自定义命令的输出路径，确保没有将.作为文件名使用

临时清理异常文件 #

若暂时无法定位脚本问题，可在GitHub Action构建步骤后添加清理逻辑：

- name: 清理意外生成的点文件
  run: |
    if [ -f ./ ]; then
      rm ./
    fi

采用体外构建（最佳实践） #

将CMake构建目录与源码目录完全分离，所有构建产物都放在独立子目录中，从根源避免源码目录被污染：

- name: 配置CMake
  run: cmake -S . -B build/

- name: 执行构建
  run: cmake --build build/

这种方式下，源码根目录不会生成任何构建文件，git状态自然保持干净。

验证git状态 #

可在流程中添加步骤确认状态，确保后续操作不受影响：

- name: 检查git状态
  run: git status

内容的提问来源于stack exchange，提问作者Doron Feinstein