horstbaerbel/ccpp-cmake-build-and-test

C/C++开发环境镜像

镜像概述

本镜像基于ubuntu:latest构建，集成了C/C++开发所需的全套工具链，旨在提供一个开箱即用的开发环境，满足C/C++项目的构建、测试、代码质量检查及格式化需求，无需手动配置依赖。

核心功能与特性

• 基础构建工具：包含build essential，提供编译所需的基础库和工具
• CMake工具链：集成CMake 3.16和CTest，支持跨平台项目构建与测试
• 编译器套件：
  • GCC/G++ 10.3：GNU编译器，支持C/C++标准
  • Clang 11：LLVM编译器，提供高效编译与诊断能力
• 代码质量工具：
  • Clang-tidy 11：静态代码分析工具，检测代码缺陷与风格问题
  • Clang-format 11：代码格式化工具，统一代码风格
• Python环境：包含Python 3.8和pip3 21，支持Python辅助脚本开发

使用场景与适用范围

• C/C++项目的编译与构建
• 单元测试与集成测试（配合CTest）
• 代码静态分析与质量检查（使用Clang-tidy）
• 代码格式化与风格统一（使用Clang-format）
• 需要Python脚本辅助的C/C++开发流程

使用方法与配置说明

基本使用

通过docker run命令启动容器，挂载本地项目目录进行开发：

bash
docker run -it --rm -v /path/to/your/project:/workspace c_cpp_dev_env

参数说明：

• -it：交互式终端
• --rm：退出后自动删除容器
• -v /path/to/your/project:/workspace：将本地项目目录挂载到容器内/workspace路径

项目构建示例

在容器内进入项目目录，使用CMake构建：

bash
# 进入工作目录
cd /workspace

# 生成Makefile
cmake .

# 编译项目
make

代码检查与格式化

使用Clang-tidy检查代码

bash
# 检查单个源文件（指定C++标准）
clang-tidy your_source.cpp -- -std=c++17

# 检查整个项目（配合CMake）
cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON .
clang-tidy -p .

使用Clang-format格式化代码

bash
# 格式化单个文件（直接修改原文件）
clang-format -i your_source.cpp

# 格式化目录下所有C/C++文件
find . -name "*.cpp" -o -name "*.h" | xargs clang-format -i

扩展配置

可通过Dockerfile基于此镜像添加项目特定依赖，或在运行时通过环境变量调整工具行为（如设置默认C++标准）：

bash
docker run -it --rm -e CXXFLAGS="-std=c++17" -v /path/to/project:/workspace c_cpp_dev_env