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

很多工程師可能都有這樣的困擾，項目工程在切換到不同 IDE 的時候，原本的中文注 釋，卻顯示成了亂碼，如果文件比較多，也不太可能重新備注這些注釋。

對于 IDE 來說，中文注釋之所以會顯示為亂碼，是因為被錯誤的解析了，或者說被錯誤的“協(xié)議”所解析而導(dǎo)致顯示錯亂，那么我們只要按照正確的或者兼容的“協(xié)議”解析中文字符即可。

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

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

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

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

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

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

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

我們同樣也通過 IAR 新增了一個文件，在里面編寫了中文的注釋，見圖 4。

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

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

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

小技巧：如果你的上述界面中沒有 GBK 選項，可以直接輸入 GBK，并回車即可。

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

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

實際上，我們在移植過程中，有時候是不會注意之前的文件是用的哪種編碼方式的， 我們可以用 UTF-8 和 GBK 分別嘗試一下即可，因為大部分情況下，都能被這兩者格式解析。

以上通過一個簡潔的方式向大家展示了，如何在 STM32CubeIDE 中顯示中文注釋，希望對大家有所幫助。