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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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