flash网站带后台,住房和城乡建设部主网站,如何制作网站图片,浙江专业做网站目录 1. CMake 基础构建工具及作用相关配置文件 2. 配置 tasks.json关键字段详细解释 3. 配置 launch.json关键字段详细解释 4. 配置 CMakeLists.txt关键部分详细解释 5. 构建和调试项目1. 仅构建项目1.1 任务执行顺序1.2 cmake 任务执行详情1.3 build 任务执行详情1.4 构建后的… 目录 1. CMake 基础构建工具及作用相关配置文件 2. 配置 tasks.json关键字段详细解释 3. 配置 launch.json关键字段详细解释 4. 配置 CMakeLists.txt关键部分详细解释 5. 构建和调试项目1. 仅构建项目1.1 任务执行顺序1.2 cmake 任务执行详情1.3 build 任务执行详情1.4 构建后的 build 文件夹内容 2. 构建并调试: 项目结构如下图:
1. CMake 基础
CMake 是一个跨平台的构建系统生成器能够生成各种构建工具的配置文件如 Makefile、Ninja、Visual Studio 项目文件等。CMake 使用 CMakeLists.txt 文件来描述项目的构建过程。
构建工具及作用 Makefile: 由 GNU Make 使用适用于类 Unix 系统如 Linux 和 macOS。它通过定义一系列规则和依赖关系自动化编译和链接过程。因此在windows系统下使用需要下载MinGWMinimalist GNU for Windows 或 MSYS2 等工具链以获得 GNU Make 的功能。 Ninja: 一个专注于速度的小型构建系统适用于大型项目。它比 Make 更高效特别适合需要快速构建的场景。 Visual Studio 项目文件: 用于 Windows 平台兼容 Microsoft Visual Studio 开发环境。它允许开发者在 Visual Studio 中管理和构建项目。
相关配置文件 CMakeLists.txt: 主配置文件位于项目根目录定义了项目的构建配置、目标、依赖关系等。 build/ 目录: 生成的构建文件存放的目录通常由 CMake 自动生成和管理。 Makefile 或 build.ninja: 由 CMake 根据指定的生成器生成的构建配置文件用于实际的编译和链接过程。
本文默认读者具备 CMake, Make 以及 g 相关命令和配置的基础知识。
2. 配置 tasks.json
tasks.json 文件用于定义 VS Code 中的自定义任务这些任务可以在命令面板中运行。以下是一个典型的 tasks.json 配置示例
{// tasks.json 版本号version: 2.0.0,tasks: [{// 任务标签用于在其他任务中引用label: build,// 任务类型shell 表示在shell中执行命令type: shell,// 要执行的命令command: cmake --build \${workspaceFolder}/build\,// 任务组配置group: {// 指定任务类型为构建kind: build,// 设置为默认构建任务isDefault: true},// 指定此任务依赖的其他任务这里依赖cmake任务dependsOn: [cmake],// 用于在VSCode中识别编译错误的匹配器problemMatcher: [$gcc]},{label: cmake,type: shell,// 生成CMake构建文件指定生成器为MinGW Makefilescommand: cmake,args: [-B,${workspaceFolder}/build,-G,MinGW Makefiles,-S,${workspaceFolder}],// 任务的工作目录配置options: {cwd: ${workspaceFolder}}}]
}关键字段详细解释 label: 任务的名称用于在命令面板或其他任务中引用该任务。例如可以在 dependsOn 中引用此标签。 type: 任务类型决定了任务如何执行。 shell: 表示任务将在系统的默认 shell 中执行命令。适用于需要通过 shell 解释器运行的命令如 bash, cmd, PowerShell 等。 process: 表示任务将直接启动一个独立的进程来执行命令而不通过 shell。适用于需要直接调用可执行文件或脚本的情况。 command: 要执行的主要命令。例如cmake、make、g 等。 args: 传递给 command 的参数列表。每个参数作为数组的一个元素。 group: 任务组配置用于组织任务。 kind: 任务类型如 build、test 等。这有助于在 VS Code 中对任务进行分类和筛选。 isDefault: 布尔值指示该任务是否为默认任务。默认任务通常在按下 Ctrl Shift B 时执行。 dependsOn: 指定当前任务依赖的其他任务。只有在依赖的任务完成后当前任务才会执行。例如build 任务依赖于 cmake 任务确保先生成构建文件再进行编译。 problemMatcher: 问题匹配器用于捕获编译过程中产生的错误和警告信息。这些信息将在 VS Code 的“问题”面板中显示便于调试。例如$gcc 匹配器用于匹配 GCC 编译器的输出格式。
3. 配置 launch.json
launch.json 文件用于配置 VS Code 的调试设置。以下是一个典型的 launch.json 配置示例
{// 使用 IntelliSense 了解相关属性。// 悬停以查看现有属性的描述。// 欲了解更多信息请访问: https://go.microsoft.com/fwlink/?linkid830387version: 0.2.0,configurations: [{// 配置名称显示在调试配置下拉菜单中name: Debug ast,// 调试器类型C (GDB, LLDB)type: cppdbg,// 请求类型launch表示启动程序request: launch,// 要调试的可执行文件路径program: ${workspaceFolder}/build/ast,// 传递给程序的命令行参数args: [],// 是否在程序入口点暂停stopAtEntry: false,// 程序的工作目录cwd: ${workspaceFolder},// 要传递给程序的环境变量environment: [],// 是否使用外部控制台窗口externalConsole: false,// 调试器模式gdbMIMode: gdb,// GDB调试器的路径miDebuggerPath: D:/mingw64/bin/gdb.exe,// GDB调试器的设置命令setupCommands: [{// 启用GDB的美化打印功能description: Enable pretty-printing for gdb,text: -enable-pretty-printing,ignoreFailures: true}],// 启动调试前要执行的任务preLaunchTask: build} ]
}关键字段详细解释 name: 调试配置的名称将在调试面板中显示方便用户选择和识别不同的调试配置。 type: 调试类型指定使用的调试器。 cppdbg: 表示使用 C 调试器如 GDB 或 LLDB。适用于调试 C 程序。 request: 调试请求类型。 launch: 表示启动一个新的调试会话加载并运行指定的程序。 program: 要调试的可执行文件的路径。通常指向构建生成的二进制文件。 args: 传递给程序的命令行参数。可以是一个字符串数组每个元素作为参数传递给程序。 stopAtEntry: 布尔值指示调试器是否在程序入口点如 main 函数暂停。这对于逐步调试程序非常有用。 cwd: 程序的工作目录。程序运行时的当前工作目录可以不同于项目的根目录。 environment: 要传递给程序的环境变量列表。可以用于配置程序运行时的环境。 externalConsole: 布尔值指示是否使用外部控制台窗口运行程序。false 表示在 VS Code 的集成终端中运行。 MIMode: 调试器模式指定使用的调试器类型。 gdb: 表示使用 GNU Debugger (GDB)。 miDebuggerPath: 调试器的可执行文件路径。指定 GDB 的具体路径确保 VS Code 能找到并使用正确的调试器。 setupCommands: 调试器的设置命令列表。用于配置调试器的行为如启用美化打印功能。 preLaunchTask: 在启动调试前要执行的任务名称。例如build 任务会先编译项目然后启动调试。
4. 配置 CMakeLists.txt
CMakeLists.txt 文件用于描述项目的构建配置。以下是一个完整的 CMakeLists.txt 示例并对关键部分进行了详细解释
cmake_minimum_required(VERSION 3.19)
project(pi)# 设置C标准
set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_STANDARD_REQUIRED ON)# 设置编译器选项
if(MSVC)add_compile_options(/utf-8)
else()# 对于 MinGW 和其他非 MSVC 编译器设置 UTF-8 编码选项add_compile_options(-finput-charsetUTF-8 -fexec-charsetUTF-8)
endif()# 添加调试标志
set(CMAKE_BUILD_TYPE Debug)
set(CMAKE_CXX_FLAGS_DEBUG ${CMAKE_CXX_FLAGS_DEBUG} -g)# 添加头文件搜索路径
target_include_directories(ast PRIVATE${CMAKE_SOURCE_DIR}${CMAKE_SOURCE_DIR}/parser${CMAKE_SOURCE_DIR}/ast
)
include_directories(./ ./ast ./parser)file(GLOB_RECURSE SOURCE ast/*.cpp parser/*.cpp)
add_executable(ast ${SOURCE} ast.cpp)关键部分详细解释 cmake_minimum_required(VERSION 3.19): 指定所需的最低 CMake 版本确保使用必要的功能和语法。 project(pi): 定义项目名称为 pi。项目名称可以在整个 CMakeLists.txt 文件中引用。 set(CMAKE_CXX_STANDARD 11): 设置 C 标准为 C11。 set(CMAKE_CXX_STANDARD_REQUIRED ON): 强制要求使用指定的 C 标准否则 CMake 将报错。 编译器选项: MSVC: 如果使用的是 Microsoft Visual C 编译器添加 /utf-8 选项以启用 UTF-8 编码。 其他编译器: 对于 MinGW 等非 MSVC 编译器添加 -finput-charsetUTF-8 和 -fexec-charsetUTF-8 选项以支持 UTF-8 编码。 set(CMAKE_BUILD_TYPE Debug): 设置构建类型为调试模式这会影响生成的二进制文件包含调试信息。 set(CMAKE_CXX_FLAGS_DEBUG ${CMAKE_CXX_FLAGS_DEBUG} -g): 在调试模式下添加 -g 标志以生成调试信息便于调试器使用。 头文件搜索路径: target_include_directories(ast PRIVATE ...): 为特定目标 ast 添加私有头文件搜索路径。 include_directories(...): 为所有目标添加全局头文件搜索路径。 源文件收集: file(GLOB_RECURSE SOURCE ast/*.cpp parser/*.cpp): 递归地收集 ast 和 parser 目录下的所有 .cpp 文件。 add_executable(ast ${SOURCE} ast.cpp): 将收集到的源文件添加到可执行文件 ast 中。
5. 构建和调试项目
1. 仅构建项目
在VS Code中可通过快捷键 Ctrl Shift B 触发构建任务。此操作会按照预先配置的任务依赖关系自动执行构建流程具体过程如下
1.1 任务执行顺序 触发 preLaunchTask: build 任务 当执行构建操作时首先会根据 launch.json 文件中的配置触发 preLaunchTask 为 build 的任务。这一过程确保在进行实际构建之前所有必要的准备工作都已就绪。 build 任务依赖 cmake 任务 build 任务被配置为依赖于 cmake 任务。这意味着在执行 build 任务之前CMake 需要先运行以生成构建系统所需的配置文件如 Makefile 或 Ninja 文件。
1.2 cmake 任务执行详情 执行 cmake 任务 cmake 任务负责生成构建配置文件。它会根据项目根目录下的 CMakeLists.txt 文件中的指令生成适用于指定生成器如 MinGW Makefiles的构建文件。 具体执行过程如下 初始化 CMake 配置 CMake 读取 CMakeLists.txt 文件解析项目设置、目标、依赖关系等信息。 生成构建文件 根据指定的生成器如 MinGW MakefilesCMake 在 build 目录下生成相应的构建配置文件如 Makefile。
1.3 build 任务执行详情 执行 build 任务 在 cmake 任务完成后build 任务会调用生成的构建系统如 make来编译和链接项目源代码生成最终的可执行文件。 具体执行过程如下 编译源文件 使用编译器如 g将源代码文件.cpp编译成对象文件.o 或 .obj。 链接对象文件 将所有对象文件和必要的库文件链接在一起生成最终的可执行文件如 ast.exe 或 ast。 生成构建产物 在 build 目录下生成可执行文件、中间对象文件以及其他构建产物。
1.4 构建后的 build 文件夹内容
构建完成后build 文件夹将包含以下主要文件和目录 Makefile 由 CMake 生成用于 Make 工具的构建配置文件。它包含了编译和链接项目所需的所有指令。 编译生成的二进制文件 Windowsast.exeLinux/macOSast 这是最终生成的可执行文件可以直接运行以测试程序功能。 中间对象文件 如 .oLinux/macOS或 .objWindows文件。这些文件是源代码编译后的中间产物用于最终的链接阶段。
2. 构建并调试:
设置断点: 在代码编辑器中, 点击行号左侧以设置断点点击右上角的调试按钮: 选择调试配置 在调试视图的顶部下拉菜单中选择预先配置的调试配置 Debug ast(该名称是launch.json文件中自定义的)。该配置在 launch.json 文件中定义指定了调试器类型、目标可执行文件、启动参数等。 之后会自动构建并执行代码到断点处进行调试
