Qt Designer中修改HLine/VLine厚度无效及线条不全的解决方法

问题场景 #

开发简易UI界面做控件分隔时，使用HLine/VLine线条控件遇到两个问题：

• 调整线条厚度的操作无效
• 最终绘制的线条显示不完整

此前尝试直接修改lineWidth属性调整厚度，操作界面如下：

错误原因 #

HLine/VLine本质是QFrame类的派生控件，直接修改lineWidth不生效、显示残缺的核心原因有两个：

1. 默认状态下控件的frameShadow属性为Sunken（凹陷）或Raised（凸起），这类3D样式下，lineWidth的数值会被用于绘制阴影边框，实体分隔线的实际厚度由midLineWidth属性控制，单独改lineWidth看不到视觉变化。
2. 布局默认给HLine/VLine分配的空间只有1px，当你把线条厚度调大后，超出分配空间的部分会被布局直接裁切，就会出现线条显示不全、断断续续的问题。

正确实现方案 #

方案1：调整QFrame原生属性（无样式表场景用） #

不要单独修改lineWidth，按顺序配置三个属性即可：

• 确认frameShape属性：水平分隔线设为HLine，垂直分隔线设为VLine
• 将frameShadow属性改为Plain（纯平无阴影模式），此时lineWidth的数值会直接对应实体线条的厚度
• 给控件设置固定尺寸预留足够显示空间：水平分隔线设置fixedHeight = lineWidth + 2，垂直分隔线设置fixedWidth = lineWidth + 2，避免被布局裁切

代码示例（Qt C++/PyQt/PySide逻辑通用）：

# PyQt/PySide 水平3px厚分隔线示例
hline = QFrame()
hline.setFrameShape(QFrame.HLine)
hline.setFrameShadow(QFrame.Plain)
hline.setLineWidth(3)
hline.setFixedHeight(5) # 预留2px边距避免裁切

方案2：用QSS样式表控制（推荐，灵活度最高） #

不需要调整多个原生属性，直接给控件写样式即可，支持自定义颜色、厚度、圆角，不会出现裁切问题：

/* 水平分隔线样式，厚度2px，浅灰色 */
QFrame[frameShape="4"] {
    border: none;
    background: #e5e5e5;
    max-height: 2px;
}
/* 垂直分隔线样式，厚度2px，浅灰色 */
QFrame[frameShape="5"] {
    border: none;
    background: #e5e5e5;
    max-width: 2px;
}

如果是在Qt Designer里操作，直接把上述样式粘贴到控件的styleSheet属性栏即可，线条会自动适配布局长度/高度，不会出现显示残缺的问题。

内容的提问来源于stack exchange，提问作者tad