實(shí)戰(zhàn)經(jīng)驗(yàn) | STM32CubeIDE實(shí)用技巧之中文注釋

很多工程師可能都有這樣的困擾，項(xiàng)目工程在切換到不同 IDE 的時(shí)候，原本的中文注 釋?zhuān)瑓s顯示成了亂碼，如果文件比較多，也不太可能重新備注這些注釋。

對(duì)于 IDE 來(lái)說(shuō)，中文注釋之所以會(huì)顯示為亂碼，是因?yàn)楸诲e(cuò)誤的解析了，或者說(shuō)被錯(cuò)誤的“協(xié)議”所解析而導(dǎo)致顯示錯(cuò)亂，那么我們只要按照正確的或者兼容的“協(xié)議”解析中文字符即可。

我準(zhǔn)備了這樣的一個(gè)測(cè)試?yán)?，測(cè)試文件分別由 IAR 和 KEIL 創(chuàng)建，并被編輯和保存過(guò)，然后加載到 STM32CubeIDE 中，通過(guò)調(diào)整文件的編碼方式來(lái)正確顯示中文注釋。

在 KEIL 中，通過(guò)菜單欄 Edit -> Configuration，進(jìn)入配置界面，可以查看到文件的默認(rèn)編碼方式是 ANSI，見(jiàn)圖 1，當(dāng)然大家也可以更改為其他的編碼方式。

▲ 圖1. KEIL 中的文件編碼方式

檢查完編碼方式后，我們?cè)?KEIL 中新增了一個(gè)文件，里面使用中文進(jìn)行注釋了，見(jiàn)圖 2。

▲ 圖2. 中文注釋在 KEIL 中的顯示效果

IAR 中，我們可以通過(guò)鼠標(biāo)右擊工程名稱(chēng)，進(jìn)入“options”菜單欄，可以顯示配置界面，可以查看到文件的默認(rèn)編碼方式是 C locale，見(jiàn)圖 3，同時(shí)，修改文件的編碼方式也是在這里。

▲ 圖3. IAR 中的文件編碼方式

我們同樣也通過(guò) IAR 新增了一個(gè)文件，在里面編寫(xiě)了中文的注釋?zhuān)?jiàn)圖 4。

▲ 圖4. 中文注釋在 IAR 中的顯示效果

我們將上述使用 KEIL 和 IAR 創(chuàng)建的文件，同時(shí)導(dǎo)入到了 STM32CubeIDE 中，會(huì)發(fā)現(xiàn) 中文顯示亂碼。通過(guò)修改文件的編碼方式發(fā)現(xiàn)，對(duì)于 IAR 的默認(rèn)編碼方式所作的中文注釋?zhuān)枰褂?GBK 的方式進(jìn)行顯示，見(jiàn)圖 5。而對(duì)于 KEIL 的 ANSI 編碼方式所作的中文注釋?zhuān)梢允褂?UTF-8 進(jìn)行解析，見(jiàn)圖 6。這樣就可以正確的顯示中文，不會(huì)出現(xiàn)亂碼， 見(jiàn)圖 7。

▲ 圖5. 在 STM32CubeIDE 中的修改文件編碼方式為 GBK

小技巧：如果你的上述界面中沒(méi)有 GBK 選項(xiàng)，可以直接輸入 GBK，并回車(chē)即可。

▲ 圖6. 在 STM32CubeIDE 中的修改文件編碼方式為 UTF-8

▲ 圖7. 中文注釋在 STM32CubeIDE 中的顯示效果

實(shí)際上，我們?cè)谝浦策^(guò)程中，有時(shí)候是不會(huì)注意之前的文件是用的哪種編碼方式的， 我們可以用 UTF-8 和 GBK 分別嘗試一下即可，因?yàn)榇蟛糠智闆r下，都能被這兩者格式解析。

以上通過(guò)一個(gè)簡(jiǎn)潔的方式向大家展示了，如何在 STM32CubeIDE 中顯示中文注釋?zhuān)Ｍ麑?duì)大家有所幫助。