PySide6 QSS样式指南：从CSS到Qt界面美化

1. PySide6与QSS基础概念解析

PySide6作为Qt for Python的官方绑定库，为开发者提供了完整的GUI开发能力。而QSS（Qt Style Sheet）则是PySide6中用于界面美化的核心工具，其语法和概念与Web开发中的CSS有着惊人的相似度。作为一个长期使用PySide6开发桌面应用的开发者，我发现很多从Web转型过来的同事会下意识地用CSS思维来写QSS，这其实存在一些需要特别注意的差异点。

QSS本质上是一种基于文本的样式描述语言，通过选择器-属性-值的结构来定义控件外观。与CSS不同的是，QSS需要遵循Qt框架的控件体系结构。举个例子，在CSS中你可能习惯用class选择器(.btn)，而在QSS中则需要使用Qt的控件类型选择器(QPushButton)。这种差异在初期容易造成困惑，但一旦掌握就能发挥巨大威力。

重要提示：QSS虽然语法类似CSS，但实际支持的属性和选择器是Qt框架定义的一个子集，并非所有CSS特性都被支持。这是新手最常踩的坑。

2. QSS核心属性分类详解

2.1 基础样式属性

QSS支持的基础样式属性构成了样式定义的基础骨架。以下是最常用的几类：

盒模型属性：

• margin：外边距（支持4个方向独立设置）
• padding：内边距
• border：边框（支持样式、宽度、颜色）
• border-radius：圆角半径

这些属性的语法与CSS几乎一致，例如：

css复制QPushButton {
    margin: 5px;
    padding: 10px 15px;
    border: 2px solid #3498db;
    border-radius: 8px;
}

背景与颜色：

• background：背景（支持颜色、渐变、图片）
• background-color：背景色
• background-image：背景图片
• color：前景色（通常是文字颜色）

一个实用的技巧是使用Qt特有的渐变语法：

css复制QPushButton {
    background: qlineargradient(x1:0, y1:0, x2:1, y2:1,