1. 前言
+ L* Z3 V8 x/ r+ g: I- B6 s编译警告对于工程师们来说，是再常见不过的东西了。对于严谨的工程师们，任何 warning 都是不会忽视的。
9 r7 _2 B$ O3 H$ m( |, m4 m
2. 巧妙使用 warning

在 STM32CubeIDE 中可以通过warning（甚至 error）的方式来通知工程师，使得一些容易遗漏的配置得到重视。
0 i2 b. y/ N6 b1 S; b9 \
例如，在释放参考代码给客户时，希望客户注意到里面的项目名称和项目版本，那么我们可以在代码中，通过“#error ”来强调必须要修改的信息，通过“#warning”来备注需要注意的信息。具体代码如图 1：
0 W# U' g1 J3 x0 \" W
- ]* F6 _0 a5 ^( s

0 b/ `% c" H1 ?( C( _! F这样，当客户编译工程时，会出现 error 和 warning，见图 2，只有将“#error”和 “#warning”两行分别注释掉，才会分别消除这两项编译信息，以此达到警示客户的目的。



4 D3 o  j  t# _4 z8 I5 T2.1. 主动屏蔽特定的 warning
# Q- s8 v' L; Z7 B5 j5 l# H5 _, V2 ]在有些场景，我们还可以在特定的代码或者文件作用域内，主动屏蔽特定的 warning。
+ T: o5 r0 E" N5 a0 [. V% F2 ]4 t
1 w7 _6 b& _& \# d0 _3 n例如，工程中写了一个测试函数“void MyTestFunction(void)”，但是在工程中暂时没有被调用，直接编译会得到“Wunused-function”的 warning。

1 s: P7 R( m  U& w( l+ E, T' G; X  t但是如果在代码中添加这样的语句：
: s0 j9 N9 h7 l% e
#pragma GCC diagnostic ignored "-Wunused-function"。


& P9 o0 V( H% b% w3 u2 N/*此区间内，如果出现函数仅申明，但是没有被调用时，编译不产生warning*/ void
MyTestFunction(void)
{…}
; `" g( l* {: B# Y: |( G#pragma GCC diagnostic pop
' R2 r! O: a% h
因为我们配置了“-Wunused-function”，那么在编译时，即使 MyTestFunction 没有 被调用，编译也不产生 warning。
) b! U0 ~5 u& ^* |
我们还可以在 STM32CubeIDE 中，通过“Help”->“Information Center”->“Read STM32CubeIDE Documentation”->“C/C++ Compiler”，找到 GCC 编译器文档，从而发现更多的 warning 选项，根据需要主动屏蔽更多的 warning。见图 3 ：
6 r) S+ K5 S- ], |+ U7 o/ e+ L
- j# d. n  U% X6 b+ u# N
0 w& @4 H3 P1 M- q, Y& f
0 ^3 V. Z& J4 ^9 h5 n$ w6 J7 x3. 小结
事实上，在编译项目时，warning 和 error 同样重要，部分隐蔽的问题可能就和 warning 相关。当我们对工程代码和编译器有了更深层次的了解后，可以巧妙地使用和屏蔽 warning，帮我们更好地管理项目。


& P: z' @1 j8 j+ r* @