在.ui文件中拖拽QPushButton控件需从左侧Buttons组拖入，立即修改objectName为有意义名称（如btnSubmit），并设置text属性；若用代码创建，须指定parent、加入layout或调用show()，且信号槽连接需确保对象生命周期有效。
在.ui文件里拖拽QPushButton控件
Qt Creator 的 UI 设计器（Qt Designer）默认就带 QPushButton 控件，不需要额外安装或注册。打开 mainwindow.ui（或任意 .ui 文件）后，左侧控件栏的 Buttons 分组里就能看到 Push Button —— 直接拖进去就行。
常见错误是拖完没改 objectName，导致后续代码里找不到控件。拖入后务必在右侧面板的 objectName 属性里设一个有意义的名字，比如 btnSubmit 或 pushButton_save，别留默认的 pushButton。
- 拖控件前确认当前处于 Design Mode（不是 Edit Mode 或 Debug Mode）
- 如果左侧控件栏没有 Buttons 分组，说明当前打开的不是 QWidget 或 QMainWindow 的 UI 文件，而是纯代码文件（如 .cpp）
- 拖进去后按钮文字默认是 “PushButton”，双击即可编辑；也可在右侧面板的
text属性里改
用代码创建QPushButton并加到布局中
纯代码方式更灵活，适合动态生成按钮或逻辑控制场景。但要注意：手动 new 出来的按钮不会自动加入 UI 布局，必须显式调用 setLayout() 或 layout()->addWidget()，否则它不会显示。
示例（在 Widget 构造函数中）：
QPushButton *btn = new QPushButton("确定", this);
btn->setObjectName("btnOk");
// 如果已有 QVBoxLayout *mainLayout;
mainLayout->addWidget(btn);
- 必须传
this作为 parent，否则按钮生命周期不受窗口管理，容易崩溃 - 没设置 layout 就直接
addWidget()会触发 warning：“QLayout: Attempting to add QLayout to …” - 若用
move()+resize()定位，属于绝对布局，响应式差，不推荐用于复杂界面
给按钮加图标时资源路径总报错
图标路径写成 :/images/save.png 却提示 “invalid icon”，大概率是 qrc 文件没正确定义前缀，或者图片没真正导入进资源系统。
检查三件事：
- qrc 文件里
<qresource prefix="/images">的prefix必须和代码里路径开头一致（冒号后、斜杠前的部分） - 图片文件必须通过 Qt Creator 的资源编辑器“Add Files”导入，不能只复制进文件夹就完事
- qrc 文件保存后，要重新运行 qmake（右键项目 → “Run qmake”），否则编译时资源不生效
顺便提醒：setIconSize() 必须在 setIcon() 之后调用，否则尺寸无效。
按钮点击没反应？信号槽连错了
最常踩的坑是 connect 写错参数类型或对象生命周期不匹配。比如在局部作用域 new 的按钮，connect 时用了 lambda 捕获 this，但按钮本身没 parent，析构早于窗口，点击时 this 已失效。
- UI 文件拖出来的按钮，用
ui->btnName连接，this是安全的 - 手动 new 的按钮，确保 parent 不为空，或改用
QObject::connect(btn, &QPushButton::clicked, this, &MyWidget::onClicked) - 检查 Qt 版本：Qt5 用
&QPushButton::clicked，Qt6 要求用&QPushButton::clicked（签名没变，但宏定义更严格，拼写错一个字母就编译不过）
图标、快捷键、toolTip 这些属性看着简单，但依赖资源加载和事件循环初始化顺序——它们得在 show() 之前设置完，否则可能不生效或显示异常。
