NSIS Modern UI完成页显示异常求助：复选框白块遮挡副标题

AI 小北

2026-5-20

解决NSIS完成页复选框白色遮挡块问题

嘿，我之前也碰到过NSIS这个烦人的UI渲染问题！这个白色矩形遮挡副标题的情况，大多是控件背景样式冲突或者默认UI渲染逻辑导致的，给你几个实用的解决思路：

Modern UI 2 用户专属修复：如果你用的是MUI宏来构建完成页，直接添加透明控件的定义就能搞定。在插入完成页宏之前，加上这句：
```
!define MUI_FINISHPAGE_CONTROLS_TRANSPARENT
!insertmacro MUI_PAGE_FINISH
```
这个定义会让完成页的所有控件（包括复选框）使用透明背景，不会覆盖下方的副标题文字。

手动创建控件时的透明设置：如果是自己手动构建完成页控件，记得给复选框加上WS_EX_TRANSPARENT扩展样式，确保它的背景和页面背景一致：

Function FinishPageCreate
  ; 先创建字体（可选）
  CreateFont $0 "微软雅黑" 9
  ; 创建带透明背景的复选框
  CreateWindowEx WS_EX_TRANSPARENT ${BS_AUTOCHECKBOX} "&启动我的应用" 100 120 180 14 $HWNDPARENT ${WS_CHILD}|${WS_VISIBLE}|${WS_TABSTOP} $0
  Pop $1 ; 保存控件句柄（如果需要后续操作）
FunctionEnd

升级NSIS版本：你当前用的是3.03版本，这个版本确实存在一些UI渲染的小bug。试试升级到NSIS最新的稳定版（比如3.10及以上），很多这类控件背景的问题在新版本里已经被官方修复了。
检查背景图片/颜色设置：如果你自定义了完成页的背景图片或颜色，要确保控件所在区域的背景绘制逻辑正确，避免控件被错误填充白色背景。比如用SetCtlColors给控件设置和页面一致的背景色：
```
SetCtlColors $1 "" ${MUI_BGCOLOR} ; $1是复选框控件句柄，${MUI_BGCOLOR}是页面背景色
```