rainbow brackets lite 通过彩色括号区分嵌套层级，降低认知负荷；大型 stm32 项目中内存增8–12%，建议关闭“高亮所有匹配括号”，对 do_while(0) 等宏可加 // @no-rainbow 跳过，搭配 spectrum dark 与 jetbrains mono 效果更佳。
用 Rainbow Brackets Lite 区分嵌套层级
嵌套过深的 if、for、函数调用或宏展开，光靠缩进很难一眼看清结构边界。彩虹括号不是炫技，而是降低认知负荷的刚需工具。
安装后默认生效，但要注意几个实际影响点：
- 在大型 STM32 项目中，开启后 IDE 内存占用增加约 8–12%，建议关闭「高亮所有匹配括号」（Settings → Editor → Color Scheme → General → Braces Matching）只保留当前括号对高亮
- 与某些自定义宏（如
DO_WHILE(0)封装）可能产生误匹配，遇到时可在括号前加// @no-rainbow注释临时跳过 - 搭配
Spectrum Dark配色 +JetBrains Mono字体时，蓝/紫/青三色组合对寄存器位操作代码（如REG->CTRL |= (1 ）识别最稳定
启用阅读模式提升注释和只读代码可读性
当你频繁查看 SDK 头文件、CMSIS 定义或第三方库源码时，编辑器默认样式反而会干扰信息提取。阅读模式不是“看起来舒服”，而是让关键信息不被语法高亮淹没。
关键配置项（Settings → Editor → Appearance → Reader Mode）：
- 勾选「渲染的文档注释」：Doxygen 格式注释（如
@brief、@param）直接转为段落文本，不用悬停就能扫读 - 开启「增大行高」+「字体连写」：对
uint32_t __IO * const这类长类型声明，连字能减少字符间隙误读 - 禁用「错误和警告高亮显示」：避免在只读库文件里被红色波浪线干扰——这些错误本就不该你改
定制文件头模板统一团队注释风格
默认模板只有 /* */ 和空行，根本撑不起嵌入式项目的上下文需求。一个没填 @section LICENSE 的驱动文件，后期合规审查可能卡住整条产线。
实操要点（Settings → Editor → File and Code Templates → Includes）：
- 模板中必须包含
@file、@author、@date、@version四个基础字段，缺一不可 -
${TODO:Briefly describe the purpose of this file}不是占位符，是强制填写项——CLion 会在保存时检查是否留空并弹出提示 - STM32 项目建议额外加
@note Hardware dependency: STM32F429IGT6，避免移植到 F7 系列时遗漏时钟树重配
调整括号和缩进策略适配 C/C++ 混合项目
C 语言习惯把 { 放在行尾（K&R），C++ 模板又常需要多层缩进对齐。CLion 默认的 Allman 风格会让 extern "C" { 后续 C 函数声明显得冗余空行。
推荐组合（Settings → Editor → Code Style → C/C++）：
- Brace placement →
Next line（用于函数/命名空间） +End of line（用于if/for/struct） - Tab size = 4，Indent = 4，Continuation indent = 8：兼顾 CMSIS 头文件缩进兼容性和 C++ lambda 可读性
- 取消勾选「Keep when reformatting」→「Blank lines」：避免格式化后把硬件初始化序列中的空行全吃掉
真正难处理的是中断服务函数（ISR）里混用 C 风格位操作和 C++ RAII 对象——这种边界地带，宁可手动关掉自动格式化（// @formatter:off），也别让 IDE 强行对齐毁掉时序关键代码。
