Qt 程序在 Windows 10 顯示盾牌圖標的原因與解決

開發 Qt 桌面應用時，發現生成的可執行文件右下角出現黃盾牌圖標（UAC 提升標識），雙擊運行會彈出「用戶賬戶控制」提示。經排查，根因極其隱蔽：程序文件名包含敏感關鍵字「Patch」。Windows 10 根據文件名啟發式判斷是否需要管理員權限，「Patch/Update/Install/Setup」等詞會觸發此行為。

現象描述

• 編譯生成 MyPatchTool.exe，圖標右下角有盾牌。
• 重命名為 MyTool.exe，盾牌消失，正常雙擊運行無 UAC 彈窗。
• 代碼、清單、鏈接選項均未變化，僅文件名不同。

根因分析

Windows 應用兼容性機制包含安裝程序檢測：

1. 文件名包含 patch、update、install、setup 等關鍵字。
2. 或內部資源版本信息 OriginalFilename、FileDescription 包含上述詞。
3. 系統判定為安裝/更新類程序，自動要求 requireAdministrator 提升權限。
4. 在可執行文件圖標上疊加盾牌，提示用戶將以管理員身份運行。

解決方案

Qt 專項最佳實踐

# .pro 文件中添加
win32 {
    # 方法 1：鏈接器直接指定 UAC 級別（推薦）
    QMAKE_LFLAGS += /MANIFESTUAC:"level='asInvoker' uiAccess='false'"

    # 方法 2：嵌入自定義 manifest（可控性更強）
    # RC_FILE += app.rc
    # app.rc 內容：
    # 1 24 "manifest.xml"
    # manifest.xml 含 requestedExecutionLevel asInvoker
}

驗證方法

1. 構建發布版 release/MyApp.exe。
2. 資源管理器查看圖標：無盾牌 = 成功。
3. 雙擊運行：無 UAC 彈窗 = 成功。
4. 進程檢視器查看完整性級別：Medium = 正常用戶權限。

總結

Windows 10 的「安裝程序檢測」是把雙刃劍：保護用戶免受惡意安裝程序侵害，卻誤傷合法開發工具。文件名包含 Patch 觸發 UAC是典型誤判。解決核心在於顯式聲明 asInvoker 執行級別，而非依賴系統啟發式猜測。Qt 專案中通過 QMAKE_LFLAGS 注入鏈接器選項是最乾淨、可維護的方案。

1. 上一篇文章： C語言進程間通信：命名管道（FIFO）實現父子進程數據傳輸
2. 下一篇文章： Qt Widgets 桌面應用發布部署：windeployqt 一鍵自動化

關於C

C語言結構體大小計算深度解析：對齊規則與實戰案例

在C語言開發中，結構體大小的計算看似簡單，實則暗藏玄機。編譯

C語言求解兩個陣列元素差值的最小絕對值

本文示範如何使用 C 語言找出兩個整數陣列中所有元素兩兩配對

GTK+3 進階：標籤標記、信號交換與刪除事件處理

延續基礎視窗範例，本文展示富文本標籤 (Pango Mark

MATLAB 調用 C 程序完全指南：MEX 文件編寫、編譯、調試與性能對比

背景：為什麼要 MEX？ MATLAB 矩陣運算極快，但雙重