VC++ 多檔案專案使用 PC-Lint 完整指南：安裝、選項設定、IDE 整合與批次掃描

前言

PC-Lint 是靜態程式碼分析利器，能發現編譯器忽略的潛在缺陷。本文詳細說明在 VC6/VC2005+ 環境中，如何針對多檔案專案設定選項檔、整合至 Tools 功能表、單檔/多檔/批次掃描的完整流程。

1. 安裝與目錄結構

• 解壓至 E:\PC-Lint，執行檔 lint-nt.exe（或 lint.exe）。
• 子目錄 lnt 存放規則檔（std.lnt、env-vc6.lnt 等）。

2. 建立專案專屬選項檔 MyProj.lnt

// E:\PC-Lint\lnt\MyProj.lnt
std.lnt
env-vc6.lnt

// 專案所有包含目錄（對應 VC 專案設定的 Additional Include Directories）
-i"C:\MyProj\IncludeA"
-i"C:\MyProj\IncludeB"
-iC:\MyProj\IncludeC
-iC:\MyProj\IncludeD

// 抑制特定訊息
-e641  // 例如：轉型大小不符

關鍵：每當 Lint 報錯「找不到標頭檔」，即在這裡補充 -i 路徑。

3. VC IDE 整合：單檔掃描

1. Tools → Customize → Tools，新增項目 PC-Lint。
2. Command: lint-nt.exe（或完整路徑）。
3. Arguments: -i"E:\PC-Lint\lnt" MyProj.lnt "$(FilePath)"。
4. Initial Directory: E:\PC-Lint\lnt（若 Arguments 已含 -i 可留空）。
5. 勾選 Use Output Window（雙擊輸出行可跳轉原始碼）。
6. 編輯器游標在任意 .c/.cpp，點選 Tools → PC-Lint 即可掃描該檔。

4. 多檔案批次掃描三種方法

方法 A：Cygwin ls + xargs（需安裝 Cygwin 並加入 PATH）

// Tools → Customize → Tools
Command: ls
Arguments: *.c | xargs lint-nt.exe -i"E:\PC-Lint\lnt" MyProj.lnt
Initial Directory: 專案原始碼根目錄

方法 B：選項檔尾端加入通配符（最簡單）

// MyProj.lnt 最後一行加入
*.c
// 然後 Tools 設定
Command: lint-nt.exe
Arguments: -i"E:\PC-Lint\lnt" MyProj.lnt
Initial Directory: 專案原始碼目錄

缺點：每次只能掃描一個目錄，需手動切換 Initial Directory。

方法 C：命令列批次檔（適合 CI/夜ly 建置）

@echo off
cd /d C:\MyProj\Src
lint-nt.exe -i"E:\PC-Lint\lnt" MyProj.lnt *.c >> LintReport.txt 2>&1

5. 無 Cygwin 環境的純 DOS 批次處理

dir *.c /B > filelist.txt
// 將 filelist.txt 內容附加到 MyProj.lnt 末尾，或
lint-nt.exe -i"E:\PC-Lint\lnt" MyProj.lnt @filelist.txt

6. 常見問題與技巧

• 路徑空白：Arguments 中路徑含空白請用雙引號包裹。
• 宏 $(FilePath) vs $(FileName)：前者含完整路徑，後者僅檔名；Lint 需完整路徑才能解析相對 include。
• Output Window 未顯示：確認 Use Output Window 勾選，且 Lint 回傳碼非 0 時 VC 才會刷新視窗。
• 抑制誤報：在 MyProj.lnt 加 -eXXX 或原始碼加 //lint -eXXX 註解。
• C++11/14/17 支援：需較新版 PC-Lint (9.0+) 並載入 co-gcc.lnt 或 co-msvc.lnt 對應編譯器擴充。