4 环境搭建
4.1 安装VSCode
2 l) g0 \3 D: G" c* \4.1.1 VSCode介绍
$ {) P# u, x: E! i5 y& TVisual Studio Code (简称 VSCode / VSC) 是一款免费开源的现代化轻量级代码编辑器，支持几乎所有主流的开发语言的语法高亮、智能代码补全、自定义热键、括号匹配、代码片段、代码对比 Diff、Git 等特性，支持插件扩展，并针对网页开发和云端应用开发做了优化。因此推荐使用VSCode为文本编辑器来代替STM32CubeIDE。
VSCode是目前最流行的代码编辑器IDE，其体积小，启动速度快，效率高，使得全世界的程序员都喜欢使用它。而目前微软也收购了Git等多方代码管理以及加密平台，支持版本管理，方便储存备份程序，提高代码工作效率。
5 z/ w, P2 _: m1 P# e1 ?

" C9 @( f% H. M0 ]/ L4 {: l

; ^5 R9 y2 j  B0 u4.1.2 打开VSCode安装包
4 [6 |6 |: t1 ]3 H' o, q在“VSCode使用教程”路径打开“VSCodeUserSetup-1.52.0.exe”安装包：



点击“下一步”，到选择自定义配置时，按以下设置，全部勾选。
. ]% X/ Q( ?' L% O  T* A
8 Q8 r; q5 F) I2 i
" f# n% X0 D" k7 O! S$ R# T/ q
6 v* L3 e" M& \0 N  s$ u) C接着继续点击下一步安装完成。
9 [. `( @: m1 v  ?( Z2 _2 Z
. R6 @: T$ V! E7 n% E, t
( T( t; D3 T1 m* a4 x) Z; c" @
# e; M9 i7 |% m/ x5 a: |4.1.3 安装汉化插件
" L1 q" X# Z0 r7 V# |4 |( J快捷键“Ctrl+Shift+P”打开搜索工具栏，并输入：“Configure Display Language”
2 \, K  c" [% z) f5 a% h& {
6 F6 d0 l) R- U: L3 |' W
9 i1 z' m1 \7 V; \) I/ O
6 }( [3 t  b% B& R2 n2 }选择“en”英文为默认字体方便汉化。
5 R( k+ K2 U* L6 t
. k( _" [* ?6 [! S4 [
3 s/ H" o, b7 C# U
& x5 q) }7 w& Y2 R5 J点击后会提示重启软件。
2 r: z- s+ n2 {


重启后点击左边菜单栏的小方框，打开插件下载库。输入“Chinese”，并点击第一个插件“Install”。

; T# {9 N7 S+ I( m
8 g" V+ ^' S- T6 f1 H
4.1.4 安装GCC驱动
5 e7 r( Y- o+ w5 l5 ~5 RWindows系统上如果不安装GCC驱动则无法使用“C /C++语言”的插件。
打开“mingw-get-setup”安装包。

& U  ~/ u/ I7 d1 l5 S' ]
3 r0 Q0 y  f( g/ N& ]$ G
一路Next完成安装，选项都不用改。
' T2 L, `2 y! B


进入程序洁面后选择"All Packages"=>“MinGW”=>“MinGW Base System”,勾选"mingw32-gcc-bin"

( ]! W) H; E- R2 c

勾选好后点击“Installation”=>“Apply Changes”,等待安装就OK了。

( E9 s. G0 ^% a4 }1 v* c4 d

接着在系统中添加GCC的环境变量。
* v# h1 @9 i4 `# \" J, h1 c鼠标右键"此电脑"=>“属性”=>“高级系统设置”，选择“高级”选项下的“环境变量”，在系统变量里点“新建”，填写MinGW的安装路径。





/ M6 F( F0 Q6 K

8 Q: W8 X$ N, h. K9 l1 U+ C. ]! |
2 ]/ Y( z& C3 g2 J4 S

& B( q# m. k3 J' j: b再在系统变量中下拉接着找到“Path”的变量，点击进行编辑：
% c! _6 B5 y* w# {% a


并添加：“C:\MinGW\bin ” 即可完成C语言插件的环境配置。
# g; x" K! u7 a1 \: v" Y- M% N5 d


* q) z) @; `! `' k& Q4.2 安装VSCode插件
4.2.1 安装Cortex语言包
7 j6 b: j! X/ e' F. E( ?: r! l, W默认安装的VSCode中是不支持任何语言的，因此我们需要安装相应的语言包。
还是点击左边的小方框打开插件安装界面。
0 {$ ~# I5 c0 z" g$ c  z) K
- B3 i( d* _" T2 W7 r
( w7 |! `6 g* S5 s0 O


0 B$ ~( M' k$ V1 }0 h: t% h) f. [分别搜索：”C/C++”,” Cortex Debug”,” C++ Intellisense”“ARM”四个插件进行安装。之后可以在已安装中看到这几个插件。

' e- E/ c' c$ Q
( q0 o/ n, G2 @  T! m
4.3 VSCode插件推荐
* ?9 M) X7 Q1 }+ ~  R1 u) l本章不涉及重要操作，可选择跳过
VSCode最厉害的部分就是能提供所有人免费下载其他人使用的插件，定制化自己的IDE，来提高代码的效率，下面本文推荐一些比较好用的插件，安不安装看个人喜好：
0 K7 Q- i2 ]" t, S) F
4.3.1 Keil Assistant
: w( {2 m! q+ ^1 C- Q  ~4 z8 N0 A
$ G* w+ M& z( a: H% \! K* p3 C0 A

) T% f5 U5 {) {, [: _( A7 S- qvscode 上的 Keil 辅助工具，与 c/c++ 插件配合使用.
1 E2 N7 K7 j: i能够为 Keil 项目提供 语法高亮、代码片段 的功能，并支持对 keil 项目进行 编译、下载。仅支持 Keil uVison 5 及以上版本
9 p% i% E) `6 z$ O: t0 ~! \
4.3.2 vscode-icons



VSCode上的图标管理工具，能够增加工程文件内的文件图标，方便快速找到对应的文件夹以及文件。可以看到原本没有图标的资源管理器有了对应的图标，方便查找文件。

3 R0 O8 {9 _+ n7 X



+ ]6 V- u  L" l: B5 l1 A: Y; q4.3.3 Prettier

代码自动换行器，保存的时候自动对代码整理，将过长的代码分割成几个小代码，
- j, ]: F$ m6 e


! g9 P7 m/ j# \) l. X3 W

9 t' c0 B8 F6 F( z- Z安装插件后，使用快捷键“Shift+ALT+F”即可自动美化代码。也可以设置成保存时自动美化代码，使用快捷键“Ctrl”+“，”进入设置界面，在搜索栏中搜索“Save”，找到“Ediitor：Format On Save”的保存功能并打勾。就可以在保存时自动整理代码。


. f3 D3 X8 P: @: N7 x2 e
2 x" O& n( x% y; y2 |) {4.3.4 Sort Lines

# K3 o) C! ]2 s( w
( `9 S6 R+ o( s( T
: t" ?* N# N- H6 I& y: v4 N自动排序功能，可以对选中代码排序，选中需要排序的代码后，按快捷键“F9”对这些代码进行A→Z的顺序排序，也可以按“F1”选择自己想要的顺序排序。多适用于多个部件变量命名的排序(例如下图电机命名)。


8 b% W' v6 n0 I* O* e+ X+ H
4.3.5 Code Spell Checker

$ p4 F+ Z( U! J. e' W
! k7 g& p! g* V: S, e
英文单词纠错助手，会用波浪线提示你哪些英文单词拼写有误。如果说想要把某个单词添加到纠错词库中，就点击波浪线，随后再点击前面的小灯泡选择添加至用户词库即可
" ]7 H/ Q& o2 A0 N: D5 q% ?$ d5 Z& I/ e
% M7 S8 |7 v4 ?# O. A  B2 N0 j: {

) @- |6 V+ Q  ?' A+ q- G- ^4.3.6 Bracket Pair Colorizer
嵌套括号标注工具，为不同的嵌套括号使用不同的颜色，方便查看嵌套函数。



  y  j8 l6 s$ m4 M6 V& _) h+ s: _
4 m( r  }' h7 l0 d) s) t# ]% i& i
' _. i9 w9 V# ~8 n4.3.7 GitLens 
0 Z# S) m- i+ Z1 [+ P  b

+ b5 @9 K7 Q; e& m9 ]6 ]3 e
用于查看Git版本日志的日志插件，搭配版本上传系统Git使用。

4.3.8 Git History

% N5 X9 S8 G2 V) O0 ?

用于查看Git版本历史分支的插件，搭配版本上传系统Git使用。

/ n! Z- b+ T  `" X. n0 d4.3.9 STM32 for VSCode

. _# p& [: J0 L, I) _
4 L7 @- d' p$ K+ q
用于调试STM32CubeMX产生的Makefile文件，并带有烧录功能，因为本文教程是把VSCode当做文本编辑器使用，因此不需要此插件，有兴趣的可以尝试玩玩。
# l! X: Z) ~; ]6 ?6 t, Q
5 VSCode功能介绍
5.1 使用VSCode
5.1.1 用VSCode打开文件工程
方法一：打开创建的工程文件夹目录，例如CubeIDE的Project工程文件夹。右键点击文件夹空白处打开文件夹右键快捷菜单。
, M; T1 R5 _* _& x+ n5 a  |
! M/ M% [! ]: V" S0 Y& W' m
7 F. [; a- B% j1 `. y, G$ P  N0 k1 i
点击“通过Code打开”即可打开整个CubeIDE所创建的工程目录。


* ^+ A+ k4 ^2 R5 h# ~& U
方法二：在打开VSCode后，点击左上角文件菜单，选择“打开文件夹”

! G) n) S5 V, Y  C! j

5.1.2 Path/inculudes配置
打开main.c ，可能会发现很多语法报错,使用快捷键"Ctrl"+","打开设置界面,在搜索栏搜索: “intelli sense mode”，在下拉选项改成“gcc-arm”。
: T3 e, x2 Q  Z# d/ B
. b7 }! N: S6 E& }! S' u

接着使用快捷键“Ctrl+Shift+P”打开搜索栏搜索“编辑配置UI”，去添加宏定义。
- W" A! X% i6 m' W0 F; R5 y" I" x
" ~' _" g! H' v  ~0 {% D/ T7 E
9 S7 @# G) N1 h2 {- W9 I
" t- C' V- F" D
# e# n! t4 u! b/ X
5 s. @# s) O& P5 Y下拉找到定义，添加以下内容：
1 {- q+ ]# n, g
2 l" r% b. @+ X! T



这些宏定义可以在STM32CubeIDE的工程属性中看到。

$ g) x6 v" a) N% {- S0 E- a; E

并在VSCode定义上方确认包含路径中是否含有本工程的文件夹位置：

7 O, p/ `* a: h" d$ S+ o: E" k5 y6 I
4 A  a0 ]6 @, D) Z4 M5 U* d$ n. Q
; b. W$ [0 v( @C:/Users/HP/Desktop/LEDTest_Project/**

5 _! b* G" ]) }/ ]- S' V4 ]5.2 修改VSCode代码
! G5 e; f# a( g  n) N) C7 m# r5.2.1 自动补全功能介绍
% Y# a  h( K4 u' _; a3 _VSCode拥有最完善的原生自动补全功能，在输入一个字符以后下方会自动联想需要补齐的内容，而这些STM32CubeIDE需要插件才能实现。

$ F) _" j) T8 e, q& ]
; s( _5 M0 _3 m6 [9 \8 y! H
而且自动补全的代码还会带有对应的图标，例如函数是紫色的立方体，变量是白色的长方形等号等等。

5.2.2 函数定义简览功能介绍
VSCode还自带函数定义简览，将鼠标放在函数上，就会浮现出该函数的定义。

$ _4 C8 j/ D/ Z8 x, `8 H
8 u- k$ ~- ]# o: w" k
在联网后，把鼠标放在函数上甚至会出现谷歌出来的各个参数的解析。


* U4 J& m* ]4 i( h5 Y1 h4 O. q+ G
/ O* m; X  h8 v; Y& A鼠标放在函数上按快捷键“ALT”+“F12”或者右键速览定义，可以快速查看该函数定义的及其周围的函数。
# W- K! t# C6 g2 O$ n2 a) U6 r

$ K8 u1 B9 V. V% `
5.3 VSCode快捷键介绍
5.3.1 常用快捷键
“Ctrl”+“S” 保存文档。
% b" s2 E5 G. B0 W1 a7 E8 ]$ g“Ctrl”+“/” 设置/取消注释
“Ctrl”+“[”/“]” 设置缩进
“Ctrl” +“F” 搜索代码
9 Z2 Q# k9 t" `“Ctrl”+“H” 替换
“Home” 跳转到行首
“End” 跳转到行尾
“ALT”+“F12” 速览定义
“Shift” +“F12” 速览引用
“Ctrl”+“Shift”+“P” 搜索VSCode功能
7 q4 f- H/ V9 x) j- S9 `“Ctrl”+“，” 设置菜单
0 h, i" g8 X/ `9 w: ?9 {" @