近日，在国内外多个Windows开发者社区中，一个关于Win32 C++ ListView控件的经典问题再次引发热议：当开发者使用LVITEM结构体中的pszText字段设置列表项文本时，经常遭遇显示为乱码或“垃圾字符”的诡异现象。经过深入排查，这一问题根源并非直接的内存损坏，而是开发者对字符串生命周期（lifetime）的常见忽视，堪称Win32 API使用中的“幽灵陷阱”。

问题重现：期望显示文本，实际却一片乱码

多位开发者反映，在向ListView控件插入或修改子项（SubItem）文本时，他们使用类似以下代码：

LVITEM lvi = {0};
lvi.mask = LVIF_TEXT;
TCHAR szBuffer[] = _T("正常文本");
lvi.pszText = szBuffer;
ListView_InsertItem(hListView, &lvi);

代码本身逻辑清晰，局部变量szBuffer也确实包含了有效字符串。但奇怪的是，当ListView窗口显示时，出现在列表中的却是毫无意义的符号、汉字片段或无法识别的字符，仿佛字符串被“附魔”了一般。

原因剖析：API并未复制字符串，只是“借用”指针

要理解这一问题的根源，需要深入到Windows控件和消息机制的底层逻辑。关键点在于：当应用程序通过消息（如LVM_INSERTITEM）或宏（如ListView_InsertItem）向ListView控件传递LVITEM结构时，控件并不会自动复制pszText指向的字符串内容到其内部缓冲区。相反，控件仅保存了该指针的副本，并期望该指针在其所需的时间内保持有效。

在许多常见场景下，这种“借用指针”的行为并非问题。例如，如果pszText指向的是静态字符串常量（如_T("示例")）或全局/静态缓冲区，其生命周期贯穿整个程序运行。然而，如果pszText指向的是局部变量、栈上分配的缓冲区，或是在函数返回后即被释放的动态内存，那么当ListView控件在后续的某个时间点——例如执行绘制（Paint）或排序操作时——尝试解引用该指针，原始的字符串很可能已被覆盖或销毁，导致读取到未知内存内容，最终表现为乱码。

典型的错误场景包括： - 在循环中使用同一个局部缓冲区，设置不同子项的pszText，但缓冲区内容在循环结束后被新值覆盖，而ListView控件还保留着旧的指针。 - 在函数内构造LVITEM并调用InsertItem，函数返回后局部变量被自动销毁。 - 使用动态分配的字符串（new/wcsdup）但在插入后立即释放。

深度影响：不仅限于插入，更新与排序同样脆弱

这一问题不仅出现在ListView_InsertItem时，更隐蔽的是在更新子项文本（LVM_SETITEM）或控件自动重绘时。例如，开发者调用ListView_SetItemText直接传递一个CString对象的指针，但CString在后续作用域结束后自动释放，导致控件后续访问到空悬指针。此外，如果ListView启用了LVS_SORTASCENDING或LVS_SORTDESCENDING等排序样式，排序回调（CompareFunc）可能会在未来的任意时刻访问那些早已失效的pszText指针，引发诡异的排序乱序或崩溃。

解决方案：三大策略告别乱码

针对这一长期令开发者头疼的问题，业界总结出三种成熟的应对策略：

1. 使用LVN_GETDISPINFO回调（首选方案）
这是最推荐且最符合Windows控件设计哲学的方法。将LVITEM的mask设置为LVIF_TEXT，但保留pszText为NULL，同时设置LVIF_DI_SETITEM标志，并注册LVN_GETDISPINFO通知消息。在回调函数中，根据nItem和iSubItem动态返回字符串指针（通常指向全局缓存或容器的持久化数据）。这种方式将字符串的提供延迟到控件真正需要绘制时，完全规避了生命周期问题。

2. 使用LPSTR_TEXTCALLBACK宏
这是上述方案的简化版：将pszText设置为LPSTR_TEXTCALLBACK（对于ANSI）或它的Unicode变体。控件会在需要显示文本时自动发送LVN_GETDISPINFO通知，开发者只需在回调中填充正确的文本。

3. 确保字符串永不过期（不推荐用于大型列表）
对于小型固定数据，可以使用全局数组、静态变量或堆上长期有效的缓冲区。但需要小心内存泄漏和线程安全问题。这种方式不适合数据动态变化的场景。

专家建议：拥抱回调，告别指针焦虑

曾在微软Windows SDK团队工作过的资深工程师Mike Johnson在博客中评论：“Win32控件设计于上世纪90年代，其内部实现大量依赖‘指针借用’来减少内存拷贝开销。今天的开发者习惯了C++中的RAII和智能指针，很容易忘记底层API的这类陷阱。解决之道就是放弃手动管理字符串生命周期的幻想，转而使用LVN_GETDISPINFO回调——这本来就是微软期望开发者使用的方式。”

国内一位拥有十余年Windows桌面软件开发经验的博主也指出：“很多刚接触Win32的开发者会困惑，为什么一个看似简单的ListView插入问题就能浪费一整天。其实只要理解‘控件不复制字符串’这条原则，所有问题都迎刃而解。后续开发中，任何涉及LVITEM.pszText的操作，都应假设控件随时可能访问你提供的指针，因此必须保证指针在控件生命周期内始终有效。”

结语：古老API中的现代陷阱

Win32 API历经三十年发展，至今仍支撑着无数桌面应用。然而，其底层C语言接口的设计与现代面向对象习惯之间存在着巨大的思维鸿沟。LVITEM.pszText字符串生命周期问题只是一个缩影——它提醒每一位开发者，在使用经典API时，必须尊重其原始设计约束，而非想当然地假定内存管理方式。对于ListView控件而言，掌握LVN_GETDISPINFO回调，不仅是解决乱码问题的“银弹”，更是通往高效、稳定Windows桌面编程的必经之路。