企业官网建设流程全解析

1. Qt实现登录效果的整体思路与方案选型

登录窗口这个东西，说小很小，说大也能做得很讲究。任何一个带用户体系的桌面软件，第一个和用户打交道的界面就是它。我这些年做过不少基于 Qt 的客户端，登录模块几乎每个项目都要重写一遍，写得多了就总结出一套相对固定的套路：一个QDialog做窗口载体，两三个输入控件，一个负责校验的逻辑类，再配一层账号持久化。整套下来代码量不大，但每一个环节都有值得推敲的地方。这篇内容适合刚接触 Qt 的朋友，也适合已经能写界面但总觉得自己的登录窗"差点意思"的人，我会把设计取舍、控件细节、信号槽连接、密码处理、报错排查这些环节都拆开讲清楚，代码可以直接拿去改。

先说清楚这个内容到底解决什么问题。很多新手写登录界面，第一反应是拖两个QLineEdit、一个QPushButton，然后按钮的槽函数里写个if判断，相等就accept()，不等就弹个QMessageBox。能跑，但问题也很明显：密码框忘了设回显模式、回车键不能提交、窗口拉大之后控件全挤在左上角、密码明文存在配置文件里、点快了会触发多次校验。这些都是真实项目里会被测试同学揪出来的点。所以我把登录效果拆成四层来看：窗口层负责显示与生命周期，交互层负责信号槽和焦点流转，校验层负责规则判断，存储层负责账号数据的落地。四层各管各的，改起来互不影响。

为什么强调分层，我举个自己踩过的例子。早些年我把校验逻辑直接写在按钮的clicked槽里，后来产品要求"支持回车登录""支持扫码后自动填充账号"，我不得不把那段逻辑复制两遍，改一次校验规则要改三个地方，维护成本陡增。后来我把校验抽成一个独立函数甚至独立类，槽函数只负责调用，问题就消失了。这个思路不是什么高深设计模式，就是最朴素的"别把鸡蛋放一个篮子"。

另外我得提前说明，登录模块要不要连服务器，取决于你的项目形态。纯本地登录（比如工具类软件、单机版系统）只需要比对本地存储的凭据；联网登录需要发请求、处理超时、处理网络异常。这篇内容以本地登录为主线，把界面、交互、存储讲透，联网部分我会在状态反馈那一节说明怎么留出接口，方便你后续接入。

1.1 为什么登录窗口更适合用 QDialog

这是被问得最多的一个问题：登录窗到底用QWidget还是QDialog。我的答案很明确，孤立弹出的登录窗口用QDialog，理由有三条。

第一，QDialog天生带模态能力。调exec()会阻塞在那一行代码，用户不关掉登录窗就没法操作主界面，这正是登录场景需要的行为。用QWidget你得手动setWindowModality，还得自己管显示顺序，麻烦。

第二，QDialog有accept()和reject()两个现成的槽和对应的返回值。登录成功调accept()，主程序拿到QDialog::Accepted就继续走；用户点关闭或者取消调reject()，主程序拿到QDialog::Rejected就退出或者留在原界面。这一套返回值机制非常好用，我后面第 7 节会详细讲。

第三，对话框天然不进入任务栏（大多数平台下），也不会被误当成主窗口。用户体验上更干净。

那什么时候用QWidget？当你的登录界面是嵌在主窗口里的一个页面时，比如某些软件的"账号设置"面板，这时候用QWidget做子页面更合适。这两种场景不要混。

还有一个细节，如果你希望登录窗在任务栏显示（有些用户习惯切窗口找回），可以给对话框加Qt::Window标志：setWindowFlags(windowFlags() | Qt::Window)。这是个小众需求，知道有这么回事就行。

1.2 界面与逻辑分离到底怎么分

"分离"这两个字很多教程都在说，但落到代码上，具体怎么分？我给一个能直接用的判断标准：凡是需要读输入框内容、需要改控件状态的操作，放到界面类里；凡是纯粹的规则判断、数据加密、文件读写，放到逻辑类里。

举例说明。checkPassword(const QString &user, const QString &pwd)这个函数只接收两个字符串，返回一个枚举或布尔值，它不碰任何控件，属于逻辑层。而onLoginClicked()这个槽函数，它要从ui->edtUser读文本，要ui->btnLogin->setEnabled(false)，要ui->labTip->setText(...)，它属于界面层。界面层的槽函数内部只做一件事：取出数据，交给逻辑层，拿到结果，更新界面。

这么分的好处是显而易见的。逻辑层的函数可以在单元测试里直接调用，不需要启动界面；也方便你后面把本地校验换成远程请求，界面代码一行都不用动。我见过很多项目界面和逻辑缠在一起，最后想加个"账号格式校验"都无从下手，就是因为一开始没分。

1.3 一个能落地的工程目录结构

新项目建起来第一件事是把目录定好，别等文件多了再挪。我常用的结构是这样：

LoginDemo/ ├── LoginDemo.pro ├── main.cpp ├── ui/ │ ├── logindialog.h │ ├── logindialog.cpp │ └── logindialog.ui ├── core/ │ ├── authmanager.h │ └── authmanager.cpp ├── res/ │ ├── style.qss │ └── images/ └── data/ └── users.db

ui/放所有跟界面相关的东西，core/放业务逻辑，res/放样式表和图片资源，data/放运行时生成的数据库或配置文件。这个结构简单，但扩展性很好，加主窗口就在ui/下加文件，加网络模块就在core/下加文件。.pro文件里记得把新目录加进INCLUDEPATH，不然头文件找不到。

提示：资源文件建议统一用.qrc管理，图片和 qss 都塞进去。这样发布的时候不会出现"程序在开发机跑得好好的，拷到别人电脑上样式全丢了"的情况。

2. 登录界面搭建：控件选择、布局嵌套与细节属性

目录定好了，接下来就是把界面拼出来。这一步看起来简单，但新手和熟手的差距就在这里——同样两个输入框一个按钮，熟手做出来的能自适应、能回车提交、能一键清空、密码能看能藏，新手做出来的只能勉强用。这一节我把控件和布局的关键点挨个说一遍。

2.1 .ui 拖拽 和 纯代码手写，到底选哪个

先说结论：原型阶段用 .ui 拖，正式项目关键控件手动补代码。不是选一边站，而是结合使用。

.ui文件的好处是所见即所得，改个间距、调个对齐，鼠标拖两下就完事。但它的短板也很明显：复杂布局的层级在 Designer 里很难看清，控件一多就容易搞混父子关系；而且多人协作时.ui文件的 XML 冲突几乎无法优雅合并。

纯代码手写的好处是全部可控，布局嵌套一目了然，代码评审时改动清晰。缺点是调整视觉效果时要反复编译运行，效率低。

我自己的习惯是：用 Designer 快速搭出骨架，保存成.ui，然后在构造函数里对关键控件做补充设置，比如设置密码回显模式、安装事件过滤器、设置最大长度。这样两边的好处都拿到了。

如果你决定纯手写，登录窗的核心代码大概长这样：

// 构造函数里构建界面 auto *central = new QWidget(this); auto *vLayout = new QVBoxLayout(central); vLayout->setContentsMargins(40, 32, 40, 32); vLayout->setSpacing(16); auto *labTitle = new QLabel("账号登录", central); labTitle->setAlignment(Qt::AlignCenter); labTitle->setObjectName("labTitle"); auto *edtUser = new QLineEdit(central); edtUser->setPlaceholderText("请输入账号"); edtUser->setClearButtonEnabled(true); auto *edtPwd = new QLineEdit(central); edtPwd->setPlaceholderText("请输入密码"); edtPwd->setEchoMode(QLineEdit::Password); auto *btnLogin = new QPushButton("登 录", central); btnLogin->setDefault(true); vLayout->addWidget(labTitle); vLayout->addSpacing(8); vLayout->addWidget(edtUser); vLayout->addWidget(edtPwd); vLayout->addSpacing(8); vLayout->addWidget(btnLogin);

这段代码里有两个属性值得单说。setClearButtonEnabled(true)会在输入框右侧自动出现一个小叉，点一下清空内容，这是 Qt 自带的，不用自己画，很省事。setDefault(true)让按钮成为默认按钮，配合后面的回车逻辑使用。

2.2 布局嵌套的正确顺序

新手最容易犯的错是直接给控件设固定坐标setGeometry，结果窗口一拉大，控件全堆在左上角。永远用布局管理器，不要用绝对坐标，这是我踩过坑之后给自己立的规矩。

登录窗的布局我推荐"外层垂直 + 内层水平"的嵌套方式。外层QVBoxLayout负责整体从上到下排列：标题、账号行、密码行、按钮行、提示文字。其中"账号行"和"密码行"内部再用QHBoxLayout，因为左边要放一个标签或者图标，右边放输入框。

这种嵌套的好处是，当你想在密码行右侧加一个"显示密码"的眼睛图标时，只需要往那一行的水平布局里addWidget就行，不会影响其它部分的排布。

关于拉伸因子，很多人不知道addStretch()的用法。如果你希望内容整体居中而不是顶在上面，就在最后加一个addStretch()，前面也加一个，两边均衡地把内容挤到中间：

vLayout->addStretch(1); // ... 中间放所有控件 vLayout->addStretch(1);

这样窗口怎么拉，内容都稳稳地在垂直方向居中。水平方向同理。这个技巧看起来不起眼，但它直接决定了你的登录窗是"专业"还是"业余"。

还有一点，窗口的最小尺寸一定要设，setMinimumSize(360, 420)之类的。不然用户把窗口拖得很小，控件会互相重叠，很难看。同时setSizeGripEnabled(false)关掉右下角的拖拽三角，登录窗一般不需要用户调大小。

2.3 输入框和按钮的几个关键属性

QLineEdit上有几个属性几乎是登录场景的标配，我列个表方便对照：

echoMode这个属性是新手最容易忘的。忘了设，用户输入的密码就明晃晃地显示在屏幕上，这是实打实的体验事故。顺带说一句，QLineEdit::Password显示的是圆点，QLineEdit::PasswordEchoOnEdit是输入时显示明文、失去焦点后变圆点，后者在移动端更常见，桌面端一般不用。

按钮这边，setDefault(true)之外，还可以用setAutoDefault(false)控制非默认按钮的行为。对话框里如果有多个按钮，Qt 会自动把第一个按钮设为默认，有时候这不是你想要的，手动指定一下更稳妥。

另外可访问性方面，给控件设好setTabOrder，让用户按 Tab 键能在账号、密码、登录按钮之间顺次切换。默认顺序是按创建顺序来的，如果你界面是拖出来的，顺序可能乱掉，手动调一下不吃亏。

2.4 我用得最多的一段 QSS 美化

功能对了之后，颜值也得跟上。Qt 的样式表语法和 CSS 很像，上手门槛低，一段几十行的 qss 就能让登录窗脱胎换骨。下面是我常用的模板，配合objectName使用：

QDialog { background-color: #ffffff; } QLabel#labTitle { font-size: 20px; font-weight: 600; color: #1f2329; } QLineEdit { border: 1px solid #dcdfe6; border-radius: 6px; padding: 10px 12px; font-size: 14px; background: #ffffff; } QLineEdit:focus { border-color: #3b82f6; } QPushButton { border: none; border-radius: 6px; padding: 11px 0; background-color: #3b82f6; color: #ffffff; font-size: 15px; } QPushButton:hover { background-color: #2f6fe0; } QPushButton:disabled { background-color: #a8c4f0; }

加载方式有两种，一种是把 qss 打包进资源文件后在main.cpp里读出来qApp->setStyleSheet(...)，另一种是直接给单个窗口setStyleSheet(...)。全局设置更省事，局部设置更灵活，看你的项目需要。

注意：QSS 里padding和border同时设置时，如果没给border指定宽度，某些平台上 padding 会失效。养成写全border: 1px solid xxx的习惯，能省掉很多莫名其妙的排版问题。

3. 核心交互实现：信号槽、回车提交与密码回显

界面搭好只是壳子，真正让它"活"起来的是交互。这一节讲三件事：信号槽怎么连更靠谱、回车怎么触发登录、密码怎么显示隐藏切换。

3.1 信号槽连接的三种写法与取舍

Qt 的信号槽有三种连接方式，我都用过，说说各自的适用场景。

第一种是 Qt4 风格的宏写法：connect(btn, SIGNAL(clicked()), this, SLOT(onLogin()))。这种写法现在基本淘汰了，因为它的连接是在运行时检查的，函数名写错了编译能过、运行才报错，很坑。

第二种是函数指针写法：connect(btn, &QPushButton::clicked, this, &LoginDialog::onLogin)。这是我用得最多的，编译期就能检查签名是否匹配，重构改名也安全。

第三种是 lambda 写法：connect(btn, &QPushButton::clicked, this, [this]{ doLogin(); })。适合槽函数逻辑很短、不值得单独定义的场景，比如"点击清空输入框"。

给个结论：常规业务用第二种，短小的临时逻辑用第三种，永远不要用第一种。这是我在项目里跟同事反复强调的一条纪律。

还有个容易被忽略的点是connect的第五个参数，默认是Qt::AutoConnection。同线程下它就是直连，跨线程会自动变成队列连接。登录模块如果后面要接网络请求，回调可能不在主线程，这时候一定要注意别在子线程里直接改控件，得用信号槽切回主线程，否则界面会崩。

3.2 回车登录：两行代码解决的事

用户体验好的登录窗，输入完密码直接敲回车就应该登录。实现方式很简单，就是setDefault(true)加上按钮和输入框的连接。但更稳妥的做法是处理输入框的returnPressed信号：

connect(edtUser, &QLineEdit::returnPressed, this, &LoginDialog::onLogin); connect(edtPwd, &QLineEdit::returnPressed, this, &LoginDialog::onLogin);

这两个连接的意思是：不管光标停在账号框还是密码框，敲回车都会调用登录槽。这比只依赖默认按钮更可控，因为有时候焦点在别的控件上，默认按钮不一定响应。

还有个小场景：用户输入账号后按回车，你希望焦点跳到密码框而不是直接提交。这种情况就在账号框的returnPressed里做焦点转移，在密码框的returnPressed里做真正登录。分场景处理，体验会顺滑很多。

实操心得：如果你在槽函数里弹出QMessageBox，要注意模态框会抢走焦点。用户关掉提示框之后，最好把焦点重新setFocus()回密码框或者清空密码框，否则用户会需要再点一下才能继续输入。

3.3 密码显示隐藏的那个"小眼睛"

很多新手觉得这个功能很难，其实一点都不复杂。核心就两行：

if (edtPwd->echoMode() == QLineEdit::Password) { edtPwd->setEchoMode(QLineEdit::Normal); } else { edtPwd->setEchoMode(QLineEdit::Password); }

至于那个眼睛图标，有两种做法。省事的一种是用QLineEdit::addAction加一个QAction，传个图标进去，设好位置为QLineEdit::TrailingPosition，然后连接triggered信号。这种做法不用管布局，图标会自动贴在输入框内部右侧，非常干净。

讲究一点的做法是在输入框右边叠一个QToolButton，通过水平布局塞进去，再根据状态切换两张图标。这种做法可控性更高，比如你想让图标在鼠标悬停时有颜色变化，用QToolButton配合 QSS 更方便。

我一般选第一种，因为代码量少、不容易出错。第二种留给那些对细节吹毛求疵的项目。

4. 登录校验与状态反馈的完整实现

交互通了，接下来是校验。这一节我讲清楚三件事：校验该写在哪、怎么防止用户狂点按钮、提示信息怎么给才不烦人。

4.1 本地登录校验的三种典型思路

第一种是硬编码比对。账号密码直接写在代码里，if (user == "admin" && pwd == "123456")。这种只适合学习演示，正式项目千万别用，反编译一下全暴露了。我把它列出来就是想说明，它确实能跑，但毫无工程价值。

第二种是本地文件比对。账号密码存在配置文件或者 SQLite 里，登录时读出来比对。这种方式适合单机软件，比如某个仪器配套的上位机，用户名密码是出厂时写好的。第 5 节我会给出具体实现。

第三种是远程校验。客户端把账号密码（哈希后）发给服务端，服务端返回结果。这是联网软件的标准做法。这种场景下界面层要做的事情更多：登录中要转圈、要禁用按钮、要处理超时、要处理断网，这些都属于"状态管理"。

不管用哪种，有一个原则是共通的：界面层永远只关心"成功"还是"失败"，不关心"为什么失败"的具体细节。具体细节由逻辑层返回一个错误码或者错误信息字符串，界面层只负责展示。这种约定能让代码结构非常清晰。

4.2 登录过程中的按钮锁定与防重复点击

用户在登录时最常见的操作是什么？狂点按钮。尤其是本地校验有一点点耗时，或者联网请求慢的时候，用户会以为没反应，然后连点五下，结果触发五次请求。这个问题必须处理。

做法很简单，在登录槽的开始禁用按钮，结束时恢复：

void LoginDialog::onLogin() { if (m_busy) return; // 第二道保险 m_busy = true; ui->btnLogin->setEnabled(false); ui->btnLogin->setText("登录中..."); const bool ok = AuthManager::instance()->verify( ui->edtUser->text().trimmed(), ui->edtPwd->text()); if (ok) { accept(); } else { ui->labTip->setText("账号或密码不正确"); ui->btnLogin->setText("登 录"); ui->btnLogin->setEnabled(true); m_busy = false; ui->edtPwd->clear(); ui->edtPwd->setFocus(); } }

这里有两个细节值得说。一是m_busy这个标志位，它是第二道保险。为什么禁用了按钮还需要它？因为按钮的clicked信号和returnPressed信号可能几乎同时触发，光靠setEnabled挡不住。二是密码错误后要clear()密码框并把焦点放回去，这是基本礼貌，用户不用再手动全选删除。

如果是联网登录，verify会变成异步的，这时候m_busy的清除就要放到回调里。异步场景下建议用QPointer或者QScopedPointer管理请求对象，防止回调回来的时候窗口已经被用户关掉了，那样会导致野指针崩溃。这是我在真实项目里被坑过的地方，窗口关闭时记得断开所有未完成的请求。

4.3 提示信息怎么给才不烦人

登录失败的提示，新手喜欢用QMessageBox::warning弹一个模态框，用户点确定才能继续。这种方式能用，但体验说实话一般，因为它打断了操作流。

我的建议是区分场景：格式类错误（账号为空、密码太短）用界面内的文字提示，红字显示在按钮下方；凭据类错误（账号密码不匹配）用文字提示或者轻微的抖动动画；系统类错误（网络异常、数据库打不开）才用模态框，因为这类错误用户需要明确知道。

界面内提示就是放一个QLabel，setObjectName后配 QSS 设成红色小字号，平时隐藏，出错时setText加show。记得在用户重新开始输入时把提示清掉，连接输入框的textChanged信号处理即可：

connect(ui->edtUser, &QLineEdit::textChanged, this, [this]{ ui->labTip->clear(); }); connect(ui->edtPwd, &QLineEdit::textChanged, this, [this]{ ui->labTip->clear(); });

至于抖动动画，用QPropertyAnimation操作窗口的pos属性，左右偏移几下就行，代码二十来行，效果很好。不过要注意窗口抖动的时候别让它跑出屏幕，偏移量控制在 8 像素以内比较合适。

5. 账号数据的存储与密码处理的正确姿势

这一节是很多教程会跳过、但实际项目绕不开的部分。账号怎么记住、密码怎么存，直接关系到软件的安全底线。

5.1 用 QSettings 实现"记住账号"

"记住我"这个勾选框，绝大多数项目记的是账号，不是密码。实现用QSettings最合适：

QSettings settings("MyCompany", "MyApp"); // 保存 settings.setValue("login/lastUser", user); settings.setValue("login/remember", true); // 读取 const QString lastUser = settings.value("login/lastUser").toString(); const bool remember = settings.value("login/remember", false).toBool();

QSettings会自动处理不同平台的存储位置：Windows 下写注册表（或 ini，取决于格式参数），Linux 下写~/.config，macOS 下写 plist。你不需要关心路径，非常好用。

构造函数里读出lastUser填进账号框，如果remember为真，把勾选框也勾上。用户取消勾选时记得remove掉键值，别留在那里。

注意：QSettings存的是明文。账号倒还好，密码千万别往里存。下面就说密码怎么办。

5.2 密码不落明文：哈希、加盐与迭代

如果项目确实需要"记住密码"（有些内网工具确实有这个需求），那也绝对不能存明文。正确做法有三层。

第一层，单向哈希。用QCryptographicHash把密码算成摘要再存，登录时对输入算摘要再比对。这样即使配置文件泄露，攻击者也拿不到原密码（理论上）。

QByteArray hashOf(const QString &pwd, const QByteArray &salt) { QByteArray data = salt + pwd.toUtf8(); // 迭代 10000 次，增加暴力破解成本 QByteArray d = QCryptographicHash::hash(data, QCryptographicHash::Sha256); for (int i = 0; i < 9999; ++i) { d = QCryptographicHash::hash(d + salt, QCryptographicHash::Sha256); } return d.toHex(); }

第二层，加盐。每个账号生成一段随机盐，和哈希值一起存。这样即使两个用户密码相同，摘要也完全不同，能有效对抗彩虹表。

第三层，迭代。就是上面代码里的循环。单次哈希在现代硬件上每秒能算几亿次，加了迭代之后暴力破解的成本会成倍上升。迭代次数不用一味求大，一万次在普通机器上耗时也就几十毫秒，用户感知不到，但破解成本提高了很多。

需要说明的是，上面这段是我基于常见实践给出的方案，如果你所在的项目有明确的安全规范，以规范为准。密码学相关的东西，自己拍脑袋实现的方案通常不如标准化方案可靠。

5.3 用 SQLite 存用户表的最小实现

如果账号不止一个，用数据库管更合适。Qt 自带的QtSql模块操作 SQLite 非常顺手，甚至不需要额外安装数据库服务。

先在.pro里加QT += sql，然后：

QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE"); db.setDatabaseName(QCoreApplication::applicationDirPath() + "/data/users.db"); if (!db.open()) { qWarning() << "打开数据库失败" << db.lastError().text(); return; } QSqlQuery q; q.exec("CREATE TABLE IF NOT EXISTS users(" "id INTEGER PRIMARY KEY AUTOINCREMENT," "name TEXT UNIQUE NOT NULL," "salt TEXT NOT NULL," "hash TEXT NOT NULL)");

比对的时候用参数绑定，别用字符串拼接：

QSqlQuery q; q.prepare("SELECT salt, hash FROM users WHERE name = ?"); q.addBindValue(user); if (q.exec() && q.next()) { const QByteArray salt = q.value(0).toByteArray(); const QByteArray hash = hashOf(pwd, salt); return hash == q.value(1).toByteArray(); } return false;

参数绑定这一步很重要，它是防止 SQL 注入的关键。用户如果输入admin' --这种内容，字符串拼接的写法会把 SQL 语句改掉，参数绑定就不会有这个问题。这一点在任何涉及数据库的项目里都要当成铁律。

实操心得：数据库文件建议放在applicationDirPath()下，而不是QDir::currentPath()。因为后者是"工作目录"，双击启动和命令行启动的结果可能不一样，我因为这个找过半小时的 bug。

6. 常见问题与排查技巧实录

写 Qt 项目，一半时间在写代码，另一半在跟环境、编码、依赖这些东西较劲。这一节我把登录模块最常遇到的几类问题整理出来，附上排查思路。

6.1 模块报错 unknown module in Qt: serialport 是怎么回事

这个报错信息在搜索里出现频率很高，它其实不属于登录模块的问题，但很多人是在做登录窗时为了调某个设备才碰上的，所以顺带讲一下。报错的形式通常是Project ERROR: Unknown module(s) in QT: serialport。

原因很直接：你的.pro文件里写了QT += serialport，但当前这套 Qt 环境里没有编译这个模块。serialport属于附加模块，某些发行版或者精简安装包里默认不带。

排查顺序是这样的：先确认你用的是哪套 Qt。用qmake -v看一下版本和路径。然后去 Qt 安装目录下的Qt版本/编译器/mkspecs/modules/目录里翻，看看有没有qt_lib_serialport.pri这个文件。有，说明模块装了，检查.pro是不是写错了；没有，说明模块确实没装，重跑一下官方安装工具，在组件列表里把对应的附加模块勾上就行。

同类报错还有Unknown module(s) in QT: sql、QT: charts等等，排查思路完全一样：先确认.pro写对了，再确认环境装了没有。九成的模块报错都是"没装"或者"装错版本"这两类原因。

顺带提一句，Qt 版本之间差异挺大，5.14、5.15 和 6.x 在模块命名上有些调整。如果你是照着旧教程做，用的却是新版本，遇到模块找不到很正常，去官方文档查一下当前版本的正确模块名即可。

6.2 中文乱码：三个位置都要检查

中文显示成方块或者问号，排查要从三个地方入手。

第一个位置是源码文件编码。C++ 源码建议统一保存为 UTF-8。如果你用的是某个默认 GBK 的编辑器，中文字符串在编译时就会出问题。Qt Creator 里可以在项目设置里指定编码。

第二个位置是字符串字面量的处理。C++ 里直接写"登录"，编译器会按源码编码解释。跨平台项目里稳妥的写法是加u8前缀，或者用QStringLiteral("登录")。Qt 5 之后QString内部统一是 UTF-16，配合QStringLiteral一般不会出错。

第三个位置是运行时的编码转换。从文件读中文、从网络收中文，都要明确指定编码。用QTextStream读文件时，setCodec("UTF-8")这一句不能少；从QByteArray转QString时，用QString::fromUtf8()而不是默认构造函数。

这三处都检查完，中文问题基本就消失了。

6.3 界面卡死：主线程被阻塞了

登录窗点下去没反应、变成白色或者有个"无响应"的标题，这是主线程被耗时操作阻塞了。常见原因有两个。

一是本地校验用了很重的哈希迭代，比如迭代一百万次。解法是把迭代次数降到合理范围，或者把校验放到子线程。放到子线程要注意，子线程里不能碰任何控件，只能通过信号把结果传回主线程。

二是联网请求用了同步方式，比如QNetworkReply配合waitForReadyRead。这种写法会让界面直接冻结到请求返回，短则几百毫秒，长则几十秒。正确做法是用信号槽异步处理finished信号，界面保持响应，同时给个加载动画。

如果确实有不得不同步的操作，可以临时开启一个局部事件循环，但这不是好习惯，能异步就异步。

6.4 开发能跑，发布之后出问题

这个坑很经典。开发机上有完整的 Qt 环境，程序当然能跑；拷到别人机器上，缺少动态库，直接闪退或者报"找不到 xxx.dll"。

解法是用 Qt 自带的部署工具。Windows 下用windeployqt，命令很简单，把编译出的 exe 拷到一个空目录，然后执行：

windeployqt --release --no-translations MyApp.exe

工具会自动把依赖的 Qt 库、平台插件拷到目录里。运行一遍之后，把整个目录打包发出去就行。

有两个地方容易漏。一是平台插件目录platforms/，里面有qwindows.dll，缺了它会报"could not find or load the Qt platform plugin"。二是样式和图片资源，如果它们没打进.qrc，发布时必须手动把文件拷过去，很容易忘。所以我一再强调资源文件要用qrc管理。

Linux 下部署要麻烦一些，可以用linuxdeployqt，或者手动ldd查依赖。这个展开讲又是一篇长文，就不在这里铺开了。

7. 登录窗与主窗口的衔接和退出逻辑

前面六节讲的都是登录窗内部的事，最后这一节说说完美的收尾：登录成功之后怎么办，用户取消怎么办。

7.1 exec() 的返回值套路

标准写法是在main.cpp里这么干：

int main(int argc, char *argv[]) { QApplication app(argc, argv); LoginDialog login; if (login.exec() != QDialog::Accepted) { return 0; // 用户取消或关闭，直接退出程序 } MainWindow w; w.show(); return app.exec(); }

exec()是阻塞的，它会一直待在那一行，直到对话框关闭。登录成功时调用accept()，返回值就是QDialog::Accepted，条件成立，继续创建主窗口；用户点右上角关闭或者取消按钮，返回值是Rejected，直接return 0结束程序。

这种写法的好处是流程线性、一眼看懂，不需要什么状态机。缺点是exec()期间的事件循环有点特殊，如果你在主线程里还有别的任务，要留意一下。对于标准登录流程，这完全不是问题。

如果你不希望"用户关闭登录窗就退出程序"（比如某些托盘常驻软件），那就改成show()加信号槽的方式，login对象要放在堆上，确保生命周期覆盖到主窗口创建。这种场景相对小众，遇到了再改也不迟。

7.2 主窗口创建时机与登录信息的传递

主窗口在登录成功之后创建，那登录得到的用户信息怎么传给主窗口？这是新手常问的。

最简单的做法是全局单例，AuthManager::instance()->currentUser()随时可以取。这种写法方便，但单例用多了会让代码耦合变重，我一般只在用户会话这种确实全局唯一的数据上用。

另一种是构造时传参，MainWindow w(userName);，把用户名作为构造函数参数传进去。这样依赖关系明确，测试也好写。用户信息不多的时候，我推荐后者。

还有一个细节：主窗口显示之后，登录窗应该被销毁。用上面的写法，login是栈对象，main函数作用域结束时自然销毁，不需要手动 delete。这就是栈对象的优势，不用操心内存管理。

如果登录窗是new出来的，记得设置setAttribute(Qt::WA_DeleteOnClose)，或者在合适的时候手动deleteLater()，否则会有内存泄漏。我在代码评审里见过不少这类遗漏，功能上没影响，但长时间运行的软件会慢慢吃内存。

最后分享一个我在实际项目里养成的习惯：登录窗关闭时，一定要清理掉所有正在进行的异步操作。如果登录时发了网络请求，用户等不及直接关了窗口，请求的回调回来时this已经销毁，轻则警告，重则崩溃。做法是在析构函数里断开所有连接，或者用QPointer判断对象是否还存在。这个坑我在早期项目里踩过不止一次，每次都是运行一段时间之后才偶发崩溃，排查起来非常痛苦，后来干脆把"关闭前清理异步"写进了项目规范。

登录这个小模块，代码量确实不大，但把上面这些细节都照顾到，写出来的东西和"能跑就行"的版本完全是两个层次。你可以先照着把基础版本跑起来，再逐条把回车、防抖、密码隐藏、盐值哈希这些加上去，每加一条就测一次，比一次性堆完再调试效率高得多。