C++/VC++ 經典疑難雜症與解決方案精選

開發過程中總會遇到一些「明明應該能跑卻跑不起來」的詭異問題。本文整理四個高頻率疑難雜症，涵蓋 MFC 編輯框換行、STL 容器選型與迭代器操作、大量刪除效能優化、宏定義副作用，附原理分析與最佳實踐代碼。

問題 1：MFC 編輯框無法換行顯示

現象

將 "12345\n6789" 設定給 CEdit 關聯的 CString 變數，呼叫 UpdateData(FALSE) 後，畫面仍顯示單行。

原因

Windows 編輯控制項的換行序列是 \r\n (CRLF)，單獨 \n (LF) 僅在 Unix/Linux 有效。

解決

m_strData = "12345\r\n67890"; // 必須用 \r\n
UpdateData(FALSE);

補充：屬性頁面必須勾選 Multiline = True、Want Return = True（允許 Enter 鍵換行）。若從檔案讀取 Unix 格式文字，需先 str.Replace(_T("\n"), _T("\r\n"))。

問題 2：std::list 迭代器無法隨機移動

現象

嘗試 it + n、it += n 編譯失敗。

原因

list 底層是雙向鏈結串列，迭代器僅支援 ++/--（BidirectionalIterator），不支援隨機存取（RandomAccessIterator）。

解決：手寫前進函式

#include <list>
#include <iterator> // std::advance, std::next, std::prev (C++11)

std::list<int> lst = {1,2,3,4,5};
auto it = lst.begin();
std::advance(it, 3); // C++98 通用做法，O(n)
// C++11 更簡潔：
auto it3 = std::next(lst.begin(), 3); // 前進 3 步
auto it_2 = std::prev(lst.end(), 2);  // 從尾部倒退 2 步

效能提醒：若頻繁需隨機存取，list 不是正確選擇，改用 vector 或 deque。

問題 3：大量刪除操作下的容器選型與優化

標準庫建議

list 的隱藏代價

• 每個節點額外 2 指標（prev/next），小型元素（如 int）記憶體開銷 300%+。
• 記憶體不連續，快取命中率極低，遍歷效能遠遜 vector。
• 大量刪除時，定位迭代器本身就是 O(n) 瓶頸。

vector 「標記-壓縮」優化法（極致效能）

不逐個 erase（導致 O(n²) 搬移），改用臨時 vector 保留有效元素，最後 swap：

std::vector<int> vec = { /* 大量資料 */ };
std::vector<int> temp;
temp.reserve(vec.size() - remove_count); // 預留空間，避免再配置

for (const auto& val : vec) {
    if (should_keep(val)) temp.push_back(val); // 只搬移一次
}
vec.swap(temp); // O(1) 交換內部指標，原 vec 記憶體隨 temp 解構釋放

優勢：單次遍歷、零額外配置（若 reserve 正確）、快取友善、無迭代器失效問題（舊迭代器不再使用）。

問題 4：宏定義 SQR(x) x*x 導致運算邏輯錯誤

代碼

#define SQR(X) X*X
int a = 10, k = 2, m = 1;
a /= SQR(k+m)/SQR(k+m); // 預期 10 / (9/9) = 10
printf("%d", a); // 實際輸出 1

展開過程

a /= (k+m)*(k+m)/(k+m)*(k+m); // 宏單純文字替換，無括號保護
// 依運算子優先序：乘除同級左結合
// = a / ( (k+m)*(k+m) / (k+m) * (k+m) )
// = a / ( (k+m) * (k+m) )   // 因 (k+m)/(k+m) = 1
// = 10 / 9 = 1 (整數除法)

正確寫法

// 方案 1：宏加括號（最低成本修正）
#define SQR(X) ((X)*(X))

// 方案 2：內聯函式（型別安全、可除錯、無副作用）——強烈推薦
template <typename T>
inline T sqr(T x) { return x * x; }

// 方案 3：C++14 constexpr 函式
template <typename T>
constexpr T sqr(T x) { return x * x; }

鐵律：能用 inline/constexpr 函式替代宏，就絕不寫宏。宏無作用域、無型別檢查、副作用難控、除錯不可見。

總結：避坑心法

1. Windows API 字串一律用 \r\n 換行，並檢查控制項屬性。
2. STL 容器選型先看存取模式：隨機存取→vector/deque；頻繁中間增刪且大型物件→list；但優先嘗試 vector + 標記壓縮。
3. 迭代器操作用 std::advance/next/prev，別手寫迴圈。
4. 宏定義加雙層括號，寧可改寫為 inline/constexpr 模板函式。
5. 大量刪除用「複製-交換」法，將 O(n²) 降為 O(n)。

這些看似微小的細節，往往就是專案從「能跑」到「穩定、高效、可維護」的關鍵分水嶺。