Squish脚本一开始看起来只是把录制结果改一改就能跑，但用例一多以后，最先失控的往往不是语法，而是复用边界。登录流程复制一份又一份，对象名散在各个脚本里，页面切换一改就要到处补。按Squish官方文档的原生结构来看，测试套件本身已经把测试用例目录、shared共享目录、对象库和全局脚本分成了不同层级，而且查找共享脚本时也有固定顺序。顺着这套结构来组织脚本，再去拆公共函数和页面对象，工程会稳很多。

在Squish里做OCR，识别错并不一定说明OCR引擎本身坏了，更常见的情况是语言提示没给对、识别区域放得太大，或者界面文本的渲染方式和默认放大参数不匹配。Qt官方文档写得很清楚，Squish默认依赖Tesseract做OCR，而且Tesseract需要单独安装；同时，OCR相关函数本身就提供了`language`、`scaleFactor`、`searchRegion`、`timeout`这些参数，说明官方本来就把语言、缩放和识别范围当成影响结果的关键因素。

在Squish里做图像识别时，很多人最容易把两件事混在一起，一件是用图片去找界面上的对象，另一件是用截图去做验证。前者更偏定位和操作，后者更偏对比和校验。Qt官方文档把这两条线分得很清楚，图像识别主要围绕`findImage`、`waitForImage`和`test.imagePresent`这些函数展开，而匹配精度则主要受tolerant模式、threshold参数、multiscale以及搜索区域控制。也就是说，图像识别能不能稳定，不只是图片本身对不对，还和查找模式与阈值设置直接相关。

在Squish里，对象映射失效最常见的原因，不是工具突然找不到控件，而是对象原来依赖的属性变了，比如标题文字变了、父对象层级变了、类名或某个动态属性变了。Squish官方文档对这件事讲得很清楚，对象映射本质上是Symbolic Name和Real Name的对应关系，脚本真正依赖的是Symbolic Name，执行时再用Real Name里的属性去查找对象。所以一旦控件属性变化，真正该修的通常不是脚本主逻辑，而是对象映射里的识别条件。

很多人第一次用Squish，觉得录制很简单，点一下Record，跟着操作一遍，脚本就出来了。可真正麻烦的地方，往往不在第一遍能不能录出来，而在第二遍、第三遍以后脚本还能不能继续用。Qt官方文档把这条线说得很清楚：录制本身是从测试套件和测试用例开始的，录制过程中会自动把对象写进Object Map，后面脚本要不要好维护，很大程度上就取决于对象名、同步方式和共用代码有没有先收顺。

很多团队刚开始用Squish时，最容易乱掉的不是录制按钮怎么点，而是工程一多以后，测试套件、公共脚本、对象库和测试数据全堆在一起，后面谁也说不清哪个目录该放什么。按Squish当前官方文档的组织方式来看，一个测试套件本身就有很明确的骨架，套件根目录里有suite.conf，测试用例各自有独立子目录，套件级共享内容放在shared下面，公共对象库和共享脚本也有固定位置。顺着这套原生结构去整理，后面的维护成本会小很多。

Squish激活失败，先不要只盯着“激活码对不对”，更要先分清这次走的是哪条授权链。Qt现在对Squish这类QA产品的许可证获取，已经纳入Qt License Service这一套流程里；官方排障文档也明确写到，用户在启动Qt或QA产品，比如Squish时，如果取不到有效许可证，问题往往会落在Qt License Service、Qt License Server、代理、防火墙、本地证书或服务配置上。换句话说，激活失败很多时候不是单一点故障，而是整条授权链里某一环没打通。

做Squish授权配置时，最容易弄混的不是安装程序，而是许可证模型本身。Qt官方现在把Squish的许可证模型分成三类，本地许可证、本地网络中的Squish Floating License Server，也就是FLS，以及Squish 9.2及更新版本可用的Qt License Server，也就是QLS。不同模型的配置方式完全不一样，本地许可证是把密钥直接配到客户端，本地浮动许可要让客户端连到一台运行中的许可服务，而QLS则是让客户端连接到一个许可证服务地址。所以真正开始配置前，先把当前组织到底用哪一种许可模型分清，后面的步骤才不会走反。

Squish的结果归档如果只停留在导出一份报告，后面做回归对比、批次追溯和失败复盘都会很吃力。更稳的做法是把结果目录、报告格式、版本号和批次号一起固定下来，让同一轮执行的XML、截图、附件和JUnit结果都能落到同一套结构里。Squish官方文档也说明，测试结果可以在IDE里查看最近结果，也可以导出并重新导入，而命令行执行时可通过报告生成器把XML结果写入指定目录；若结果包含截图或附件，官方推荐按整个结果目录打包上传或保存。

Squish结果管理如果只停留在IDE里看一眼，后面做回归对比、缺陷复盘和CI归档都会很乱。更稳的做法是把导出动作、报告格式和保存路径一次定成统一口径，让本地调试、命令行执行和流水线产物都能对上同一套规则。Squish本身同时支持IDE里的结果导出，也支持通过squishrunner生成多种报告格式，但不同格式对附件、目录和保存方式的要求并不一样。