Vscode+stlink

### 配置和使用 STLink 在 VSCode 中进行调试

#### 安装必要的软件包
为了能够在VSCode中顺利配置并使用STLink进行调试，需先确保已安装以下必要组件：

- **VSCode**: 作为主要开发环境，可通过官方网站轻松获取并完成安装[^2]。

- **GNU Arm Embedded Toolchain**: 提供ARM架构所需的编译器、调试器和其他工具。该套件对于编写嵌入式应用程序至关重要。

- **VSCode插件**:
- **Embedded Makefile (EIDE)**: 支持项目构建过程管理。
- **Cortex-Debug**: 实现对基于ARM Cortex内核的目标设备的支持，允许设置断点、单步执行等功能来辅助程序调试。

- **STLink驱动及固件更新**:
- 当遇到无法正常工作的情况时，可能是由于使用的STLink版本较低而不兼容当前的编译方式所致；此时应考虑通过STM32CubeProgrammer中的Firmware Update功能升级至最新版再尝试连接调试[^1]。

#### 设置 `launch.json` 文件用于启动调试会话
创建或编辑`.vscode/launch.json`文件以定义具体的调试参数。下面是一个适用于大多数场景的例子：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "(gdb) Launch",
            "type": "cortex-debug",
            "request": "launch",
            "servertype": "openocd",
            "executable": "${workspaceRoot}/build/${target}.elf",
            "device": "stm32f1xx", // 根据实际使用的MCU型号调整此处
            "interface": "stlink",
            "preLaunchTask": "Build Project"
        }
    ]
}

#### 修改 `settings.json` 和 `tasks.json`
还需适当修改项目的全局设置(`.vscode/settings.json`)以及任务列表(`.vscode/tasks.json`)以便更好地集成整个流程。特别是当涉及到特定于硬件平台的路径变量或其他定制化需求时更为重要。

例如，在`settings.json`中指定正确的包含目录有助于提高代码补全效率：

"c_Cpp.default.includePath":[
    "${workspaceFolder}/**",
    "/path/to/toolchain/include"// 替换成真实的toolchain include位置
],

而在`tasks.json`里则可以定义预处理命令如编译操作等：

{
    "label": "Build Project",
    "command": "make all",
    "group": {
      "kind": "build",
      "isDefault": true
    },
    "problemMatcher": ["$gcc"],
},

以上步骤完成后，理论上就可以在VSCode环境中借助STLink实现高效的编程与除错体验了。