1. 前言
2 g* H- G& J* Y3 S3 I( [6 @2 C) o  D编译警告对于工程师们来说，是再常见不过的东西了。对于严谨的工程师们，任何 warning 都是不会忽视的。
3 T  \3 ^, h# m$ g7 u% ]% b
2. 巧妙使用 warning
8 h2 B6 X2 c4 D, n1 U& j! q6 a* K
在 STM32CubeIDE 中可以通过warning（甚至 error）的方式来通知工程师，使得一些容易遗漏的配置得到重视。

例如，在释放参考代码给客户时，希望客户注意到里面的项目名称和项目版本，那么我们可以在代码中，通过“#error ”来强调必须要修改的信息，通过“#warning”来备注需要注意的信息。具体代码如图 1：
1 N) M; z3 a; n  S, b


; P* b" ]( v7 U1 `1 ]7 `这样，当客户编译工程时，会出现 error 和 warning，见图 2，只有将“#error”和 “#warning”两行分别注释掉，才会分别消除这两项编译信息，以此达到警示客户的目的。

( e( w3 D$ p2 s% [
6 t9 U+ ~8 j  O! r( C
2.1. 主动屏蔽特定的 warning
7 u8 ^; E, t& ?5 o) ]3 X9 ]在有些场景，我们还可以在特定的代码或者文件作用域内，主动屏蔽特定的 warning。
, x% }' _/ m* v# X/ C3 F  `
8 d( h$ }+ E3 }0 o( Y5 r" r( `例如，工程中写了一个测试函数“void MyTestFunction(void)”，但是在工程中暂时没有被调用，直接编译会得到“Wunused-function”的 warning。
+ @# ^" n3 v" F
但是如果在代码中添加这样的语句：
' M* Q0 I+ {4 i( L
9 q8 |. H8 v$ R. }3 D  {#pragma GCC diagnostic ignored "-Wunused-function"。


/*此区间内，如果出现函数仅申明，但是没有被调用时，编译不产生warning*/ void
MyTestFunction(void)
$ b$ Q* \  N! }% U2 V9 q, n{…}
8 [. f  |( r1 m( u$ B* j#pragma GCC diagnostic pop
' S+ Z( b1 a2 C
+ g" [3 Q% n+ c" u, j) S) @; N因为我们配置了“-Wunused-function”，那么在编译时，即使 MyTestFunction 没有 被调用，编译也不产生 warning。

我们还可以在 STM32CubeIDE 中，通过“Help”->“Information Center”->“Read STM32CubeIDE Documentation”->“C/C++ Compiler”，找到 GCC 编译器文档，从而发现更多的 warning 选项，根据需要主动屏蔽更多的 warning。见图 3 ：



" [. Y0 A* ?- f8 s. j1 S3 A3. 小结
  P7 a( C7 T4 {" v7 N* q* X事实上，在编译项目时，warning 和 error 同样重要，部分隐蔽的问题可能就和 warning 相关。当我们对工程代码和编译器有了更深层次的了解后，可以巧妙地使用和屏蔽 warning，帮我们更好地管理项目。

6 y1 _1 a% d( _# t" t
) K" V& S& |. O9 Z
7 g; B* y* G# ]% [( F0 V8 s