[color=rgb(85, 87, 112) !important]Cloud IDE [color=rgb(85, 87, 112) !important]VSCode搭建STM32开发环境（极简自我搭建&懒人直接使用插件）
VSCode搭建STM32开发环境（极简自我搭建&懒人直接使用插件）VSCode搭建STM32开发环境 [url=]
ben_black[/url] · 2020-11-24 00:11:27
[color=var(--md-editor-text-color-active)]目录
[color=var(--md-editor-text-color-active)]VSCode搭建STM32开发环境（极简自我搭建&懒人直接使用插件） [color=var(--md-editor-text-color-active)]写在前面： [color=var(--md-editor-text-color-active)]方法一：arm工具链+OpenOCD烧录 [color=var(--md-editor-text-color-active)]1.大致思路 [color=var(--md-editor-text-color-active)]2.准备工具 [color=var(--md-editor-text-color-active)]2.1安装工具 [color=var(--md-editor-text-color-active)]2.2补充说明 [color=var(--md-editor-text-color-active)]3.使用STM32CubeMX创建工程 [color=var(--md-editor-text-color-active)]4.VSCode内部配置 [color=var(--md-editor-text-color-active)]4.1添加并配置c_cpp_properties.json [color=var(--md-editor-text-color-active)]4.2添加settings.json [color=var(--md-editor-text-color-active)]4.3配置tasks.json [color=var(--md-editor-text-color-active)]4.4配置launch.json [color=var(--md-editor-text-color-active)]4.5重定向printf [color=var(--md-editor-text-color-active)]4.6引入其他库 [color=var(--md-editor-text-color-active)]5.总结 [color=var(--md-editor-text-color-active)]方法二：直接使用插件ioT Link [color=var(--md-editor-text-color-active)]1.准备工具 [color=var(--md-editor-text-color-active)]2.创建工程 [color=var(--md-editor-text-color-active)]3.其他事项（一些坑）
VSCode搭建STM32开发环境（极简自我搭建&懒人直接使用插件）[color=var(--md-editor-text-color-active)]一开始是用STM32CubeMX+Keil进行STM32的学习和开发，但是keil的界面属实有点丑。。最开始甚至有点把我劝退。抛开颜值不说，这货的代码补全功能有点菜，很多时候都不显示keyword的提示，至少在我的电脑上是这样，极个别时候倒是还反应挺快。 [color=var(--md-editor-text-color-active)]于是便想要用颜值高而且代码补全功能比较强大的vscode来进行STM32的开发。而且无论何种开发都用一个工具也比较方便。看了一些别人的博客，在这里汇总一下，也算做个笔记。 [color=var(--md-editor-text-color-active)]本教程思路为：使用STM32CubeMX生成Makefile工程（STM32CubeMX自动进行初始化配置实在太香了，应该也是目前stm32开发的主流），然后使用vscode对工程进行编写，编译和烧录。 [color=var(--md-editor-text-color-active)]总算抽出时间写完了，累死了...
写在前面：[color=var(--md-editor-text-color-active)]方法二所使用的使用ioT Link插件的方法已经不推荐使用，因为方法二是我很久以前写的，已经太久没有维护，不知道现在是个什么状况，事实上在我写完这篇文章的方法二部分之后我就再也没用过这个方法了。。 [color=var(--md-editor-text-color-active)]其次我个人也更倾向于使用方法一，因为方法一尽可能少的使用VSCode插件，仅仅利用VSCode的强大编辑功能，再通过VSCode调用简单的命令行命令去完成后续的编译烧录等，事实上和方法二的内在原理是一样的，只不过方法二会自动帮你下载需要的工具，也会帮助你调用它们。我觉得方法一比方法二要优雅的多，但不可否认的是方法二确实对新手更友好一些，不过方法一每一步的配置过程和内在的原理我已经写的很清楚了，还是希望大家即便是新手也尽可能使用方法一吧，方法二的内容我就先不删除了，虽然很可能已经过失，但或许也能给各位一些帮助。 方法一：arm工具链+OpenOCD烧录1.大致思路[color=var(--md-editor-text-color-active)]使用STM32CubeMX生成工程，生成时选项选择生成Makefile，通过make调用arm工具链编译，然后通过OpenOCD烧录。 [color=var(--md-editor-text-color-active)]通过写c_cpp_properties.json可以利用VSCode牛X的IntelliSense，可以很爽的写代码。通过task.json方便的完成编译和烧录功能，通过写launch.json以正确进入调试。 [color=var(--md-editor-text-color-active)]此外，也可以正常生成MDK或其他工程，然后vscode只写c_cpp_properties.json，这样的目的是用vscode写代码，用MDK编译和烧录，防止玄学问题发生。 [color=var(--md-editor-text-color-active)]比如我目前没有解决的一个问题是H7的dma问题。看了其他人的博客，是因为dma使用了不该它使用的内存地址，但是用MDK的话官方生成的工程已经帮你把地址规定好了，是可以正常使用的，用arm工具链编译的话我还不清楚在哪里修改这个地址，仅在代码里定向这个地址的话又不好使....有小伙伴解决了的话欢迎评论区或私信告诉我一下;) 2.准备工具[color=var(--md-editor-text-color-active)]（1）VSCode [color=var(--md-editor-text-color-active)]（2）STM32CubeMX [color=var(--md-editor-text-color-active)]（3）MinGW-w64 [color=var(--md-editor-text-color-active)]（4）arm-none-eabi-gcc [color=var(--md-editor-text-color-active)]（5）OpenOCD [color=var(--md-editor-text-color-active)]（6）Git(可选) 2.1安装工具[color=var(--md-editor-text-color-active)]安装不细说了，记得把MinGW-w64,OpenOCD,arm-none-eabi-gcc,Git添加到环境变量。 [color=var(--md-editor-text-color-active)]桌面右键点击此电脑->属性->高级系统设置->环境变量->Path->编辑->新建->浏览，选择对应的路径（到bin文件夹），最后应用->确定。 [color=var(--md-editor-text-color-active)]参考图： [color=var(--md-editor-text-color-active)]
2.2补充说明[color=var(--md-editor-text-color-active)]（3）MinGW-w64：Version版本号，选最新即可；Architecture架构跟操作系统有关，64位系统选择x86_64，32位系统选择i686;Threads线程标准windows开发选win32，其他选posix;Exception异常处理模型，x86_64可选为seh和sjlj，i686为dwarf和sjlj，一般选seh和dwarf就可;Build revision构建版本号，选择最大就可。详细可看这篇帖子 [color=var(--md-editor-text-color-active)]（6）Git：原本以为不能用powershell。。。虽然自己也觉得这不可能，但是一开始确实遇到了问题，不过现在姑且已经解决了。用git-bash的话方便一些，powershell的话有些地方要改一下，而且不如用gitbash快，主要体现在执行task时会卡一卡。关于这个地方其实我也不是很懂，不知道有没有其他方法解决，有的话欢迎评论区或私信提醒。:) [color=var(--md-editor-text-color-active)]（6）Git：后面文章已经彻底改成使用windows的powershell了，本文的宗旨是尽可能减少额外的操作，能用原生的就不下载新的。 3.使用STM32CubeMX创建工程[color=var(--md-editor-text-color-active)]前面选芯片，配置外设时钟等等正常配就好，要生成工程前点击Project Manager，在Toolchain/IDE处选择Makefile。 [color=var(--md-editor-text-color-active)]
[color=var(--md-editor-text-color-active)]然后直接GENERATE CODE。 4.VSCode内部配置[color=var(--md-editor-text-color-active)]首先在VSCode中打开刚才的工程文件夹。 [color=var(--md-editor-text-color-active)]直接按F5，选择C++(GDB/LLDB)->gcc.exe生成活动调试文件，然后会自动生成.vscode文件夹，当然啦，会报错，点中止就可以了。 [color=var(--md-editor-text-color-active)]
[color=var(--md-editor-text-color-active)]
4.1添加并配置c_cpp_properties.json[color=var(--md-editor-text-color-active)]（1）在.vscode文件夹中添加c_cpp_properties.json文件，配置了这个，VSCode才能找到includePath，写代码的时候才不会一堆红波浪线。它的基本格式是这样的： { "configurations": [ { "name": "Win32", "browse": { "path": [ ], "limitSymbolsToIncludedHeaders": true }, "includePath": [ ], "defines": [ ], "compilerPath": " ", "cStandard": "c11", "cppStandard": "c++17", "intelliSenseMode": "gcc-x64" } ], "version": 4}[color=var(--md-editor-text-color-active)]把鼠标放在对应的参数上可以看到vscode对其的解释，比如把鼠标放在path上： [color=var(--md-editor-text-color-active)]
[color=var(--md-editor-text-color-active)]首先我们看"defines"，这个是告诉VSCode你预先定义了哪些宏，怎么知道这里应该填什么呢？打开目录下的Makefile文件便可以看到： [color=var(--md-editor-text-color-active)]
[color=var(--md-editor-text-color-active)]忽略前面的-D，我们便可以知道预先定义的宏是"USE_HAL_DRIVER"和"STM32F407XX"。（一般来说一定是这两个，其中第二个就是你的芯片） [color=var(--md-editor-text-color-active)]再看"includePath"，这个是告诉VSCode去哪些目录里找头文件，怎么知道这里应该填什么呢？同样，打开目录下的Makefile寻找： [color=var(--md-editor-text-color-active)]
[color=var(--md-editor-text-color-active)]忽略前面的-I，将后面的路径填入即可。（或者可以直接偷懒填"${workspaceFolder}/**"，其中workspaceFolder表示当前目录，**表示该目录下递归遍历所有文件） [color=var(--md-editor-text-color-active)]至于"path"，似乎不是很重要，和上面的"includePath"填一样的或者填"${workspaceFolder}/"即可。 [color=var(--md-editor-text-color-active)]最后是"compilerPath"，显然是填编译器路径，把MinGW-w64下的gcc的路径填进去就可以了，例如我的是这样："D:\\Programming\\mingw64\\bin\\gcc.exe"。 [color=var(--md-editor-text-color-active)]至此，至少VSCode智能提示和代码补全功能就工作正常了，可以正常的写代码。虽然还不能编译烧录和调试，不过VSCode编辑+Keil编译烧录调试也是不错的选择（毕竟Keil的编辑功能实在是不好用，界面也丑）。 [color=var(--md-editor-text-color-active)]最后大致是这个样子： { "configurations": [ { "name": "Win32", "browse": { "path": [ "${workspaceFolder}/" ], "limitSymbolsToIncludedHeaders": true }, "includePath": [ "${workspaceFolder}/**" ], "defines": [ "USE_HAL_DRIVER", "STM32F407xx" ], "compilerPath": "D:\\Programming\\mingw64\\bin\\gcc.exe",//编译器路径 "cStandard": "c11", "cppStandard": "c++17", "intelliSenseMode": "gcc-x64" } ], "version": 4}4.2添加settings.json[color=var(--md-editor-text-color-active)]在.vscode文件夹中添加settings.json文件，添加： { "terminal.integrated.shell.windows": "D:\\Programming\\Git\\bin\\bash.exe"}[color=var(--md-editor-text-color-active)]这样便指定了该文件夹下默认shell是bash，出现提示的时候选择允许改变即可。
[color=var(--md-editor-text-color-active)]vscode更新后已经不推荐使用这种方法 [color=var(--md-editor-text-color-active)]
[color=var(--md-editor-text-color-active)] 目前虽然会警告，但仍然可以使用，而且比新方法优先级更高，也就是说目前继续使用此方法不会有任何问题，暂时 [color=var(--md-editor-text-color-active)]新方法如下： [color=var(--md-editor-text-color-active)]点击左下角小齿轮进入设置，在上方搜索栏搜索terminal default，然后点在settings.json中编辑 [color=var(--md-editor-text-color-active)]
[color=var(--md-editor-text-color-active)] 总之只要能把全局的settings.json打开就行。 [color=var(--md-editor-text-color-active)]到这个位置： [color=var(--md-editor-text-color-active)]
[color=var(--md-editor-text-color-active)] 注意"terminal.integrated.defaultProfile.windows"和"terminal.integrated.profiles.windows"可能不在同一行。 [color=var(--md-editor-text-color-active)]后者是终端配置，包含名称，路径(path)，参数(args)，图标(icon)。路径也可以不用path用source，这样它会自己寻找路径，比如我图里的PowerShell。 [color=var(--md-editor-text-color-active)]此外，名称里不能有空格，别被第二个Command Prompt骗了。如果有空格的话，这个配置不会被识别，在terminal.integrated.defaultProfile.windows填上也会报警告。 [color=var(--md-editor-text-color-active)]如果打算用Bash作为默认终端的话就像我图里一样把对应的路径写上就行了。 [color=var(--md-editor-text-color-active)]前者是默认的终端是哪个配置，值就是终端配置的名称，比如我这里是PowerShell。 [color=var(--md-editor-text-color-active)]然后，只要ctrl+shift+P然后输入terminal，选择默认配置文件，然后选择对应的就可以了。 [color=var(--md-editor-text-color-active)]
[color=var(--md-editor-text-color-active)]
[color=var(--md-editor-text-color-active)]就算配置文件里没有写任何配置，Command Prompt和PowerShell也是会存在的，可选的，但如果配置里名称有空格，是不可选的。至于我图里那个带空格的Command Prompt为啥会在我也不是很懂。= = [color=var(--md-editor-text-color-active)]这样选择终端配置文件，是全局的默认终端。仅在对应文件夹下的默认终端，可以通过文件夹下添加settings.json来实现，只需添加"terminal.integrated.profiles.windows"项即可，如： "terminal.integrated.defaultProfile.windows": "Git-Bash"4.3配置tasks.json[color=var(--md-editor-text-color-active)]tasks.json配置的是任务。对于使用PowerShell和Git-Bash，从这个地方就有些不同了。 [color=var(--md-editor-text-color-active)]自动生成的大致是这样： { "tasks": [ { "type": "cppbuild", "label": "C/C++: gcc.exe 生成活动文件", "command": "D:\\Programming\\mingw64\\bin\\gcc.exe", "args": [ "-g", "${file}", "-o", "${fileDirname}\\${fileBasenameNoExtension}.exe" ], "options": { "cwd": "${workspaceFolder}" }, "problemMatcher": [ "$gcc" ], "group": { "kind": "build", "isDefault": true }, "detail": "调试器生成的任务。" } ], "version": "2.0.0"}[color=var(--md-editor-text-color-active)]"tasks"里是包含的任务。 [color=var(--md-editor-text-color-active)]"label"顾名思义标签，可以理解为任务的名称。 [color=var(--md-editor-text-color-active)]"type"是表明任务是作为一个进程运行还是在shell中作为命令运行。 [color=var(--md-editor-text-color-active)]"command"即命令。 [color=var(--md-editor-text-color-active)]"args"是命令的参数，即arguments。 [color=var(--md-editor-text-color-active)]"options"是其他命令选项，可以删掉不管。 [color=var(--md-editor-text-color-active)]"problemMatcher"和"group"是问题匹配程序和分组用的，也不用管，删掉就行。 [color=var(--md-editor-text-color-active)]"detail"顾名思义是细节描述。
[color=var(--md-editor-text-color-active)]对于编译工作，我们使用的是make工具，MinGW-w64自带的名叫mingw32-make.exe，ctrl+`呼出终端输入"mingw32-make"回车执行，便可以编译。 [color=var(--md-editor-text-color-active)]但是 [color=var(--md-editor-text-color-active)]使用gitbash是可以的，而使用PowerShell直接调用会报错： [color=var(--md-editor-text-color-active)]
[color=var(--md-editor-text-color-active)]使用PowerShell需要我们自己先在目录中建一个build文件夹才行。但是用bash的话，它会自动建一个，这和shell自己本身有关吧。
[color=var(--md-editor-text-color-active)]当然每次都输指令还是很麻烦，因此将这个操作编入tasks即可。 [color=var(--md-editor-text-color-active)]那么"type"填"shell"，"command"填"mingw32-make"，"args"可以填"-j"提高编译速度，至于"label"和"detail"随意填就好。 [color=var(--md-editor-text-color-active)]如果使用PowerShell的话，就像我刚才说的，需要预先新建build文件夹，所以要加上一个"dependsOn"指定其依赖的其他任务。不过要用powershell的条件判断语句判断是否已经存在build文件夹，否则已经存在build文件夹的情况下mkdir会返回错误，而若每次都在新建build前先将build删除，那么每次都需要重新编译所有文件，效率是很低的。 [color=var(--md-editor-text-color-active)]此外，还可以添加一个Clean任务，用来清除编译文件。 [color=var(--md-editor-text-color-active)]Makefile里的clean操作是这样定义的，其实就是删除build文件夹及其子文件： [color=var(--md-editor-text-color-active)]
[color=var(--md-editor-text-color-active)] 对于gitbash可以直接使用"mingw32-make clean"，但是对于PowerShell是没有-fR这个参数的，总之用不了，会报和前面类似的错误。所以不用这个clean，在"commands"直接填"rm -r build"即可。
| 
楼主
