简介本资源是一个面向VC6 MFC初学者与传统C桌面开发者的轻量级日志工具实现聚焦于解决Windows平台下缺乏便捷、可嵌入式日志记录能力的问题。它提供一个结构清晰、即用型的CLog日志类支持DEBUG/INFO/ERROR等基础等级、自动时间戳、文件追加写入及格式化输出适用于调试MFC单线程GUI程序、遗留系统维护或教学演示场景。压缩包为RAR格式共2个文件1个头文件Log.h定义类接口与成员变量1个源文件log.cpp实现WriteLog、FormatTime、OpenLogFile等核心逻辑总大小仅2KB代码简洁、无外部依赖便于快速集成到现有VC6工程中。目前已有218人学习下载读者可直接获取完整可编译的日志模块源码掌握MFC环境下基于FILE指针的手动日志管理机制理解时间格式化、文件异常处理及CString字符串拼接等关键实践细节。1. VC6 MFC 环境下轻量级 C 日志类不依赖第三方库、无运行时 DLL 依赖、可直接嵌入老项目你在维护一个基于 Visual C 6.0 的遗留 MFC 桌面应用——可能是工业控制界面、医疗设备配置工具或金融终端客户端。系统部署在客户内网 Windows XP/2000 环境不允许安装任何额外运行时如msvcrtd.dll以外的组件也不能引入log4cpp、spdlog等现代日志库。此时你真正需要的不是“如何用 C 写日志”而是“如何在 VC6 MFC 单线程 GUI 程序里用纯 Win32 API 和 MFC 基础类实现线程安全、文件自动轮转、带时间戳和模块标识的printf风格日志输出”。这个vc_log.rar_c log类标题背后是一套为兼容性妥协但功能完整的落地方案它用CStdioFile封装写入、用CTime生成时间戳、用#ifdef _DEBUG控制开关、用InterlockedExchange实现简易原子锁——所有代码可直接复制进StdAfx.h后编译通过。适合 MFC 初学者快速集成也值得有经验的工程师重审其在资源受限场景下的设计取舍。2. 从零构建 VC6 兼容的 C 日志类核心结构设计与 Win32 API 选型依据2.1 为什么不用std::ofstream或CFileVC6 STL 与 MFC 文件类的兼容性陷阱VC6 的 STL 实现Dinkumware 3.0存在严重缺陷std::ofstream在构造时若路径不存在会抛出未捕获异常且不支持open()的ios_base::app模式原子追加而CFile虽稳定但其Write()接口要求传入void*缓冲区无法直接接受CString或格式化字符串每次写入需额外调用GetBuffer()和ReleaseBuffer()在频繁日志场景下易引发内存碎片。实际工程中CStdioFile是更优解——它继承自CFile但提供WriteString()和Printf()方法底层调用fputs/fprintf完全绕过 STL 异常机制且CStdioFile::Open()支持CFile::modeNoTruncate | CFile::modeCreate组合标志能确保文件存在时不清空、不存在时自动创建。这是该日志类选择CStdioFile作为底层载体的根本原因。提示VC6 中CStdioFile的Printf()方法不支持%lld或%zu仅支持%d/%x/%s/%f等基础格式符。若需打印 64 位整数必须先用_i64toa()转为字符串再拼接。2.2 日志类接口设计模仿printf语义但强制模块标识与级别控制该日志类不采用log4j风格的Logger::getInstance(ModuleA)-error(msg)链式调用而是定义简洁的宏封装// vc_log.h #ifndef VC_LOG_H #define VC_LOG_H #include afx.h #include time.h class CVcLog { public: static BOOL Init(LPCTSTR lpszLogPath, DWORD dwMaxSize 1024*1024, int nMaxFiles 5); static void Uninit(); static void Log(int nLevel, LPCTSTR lpszModule, LPCTSTR lpszFormat, ...); private: static CStdioFile* m_pLogFile; static CRITICAL_SECTION m_csLog; static DWORD m_dwMaxFileSize; static int m_nMaxBackupFiles; static CString m_strLogPath; static BOOL m_bInited; static void RotateLogFile(); static void WriteLogHeader(); }; // 宏定义简化调用 #define LOG_DEBUG(m, ...) CVcLog::Log(0, m, __VA_ARGS__) #define LOG_INFO(m, ...) CVcLog::Log(1, m, __VA_ARGS__) #define LOG_WARN(m, ...) CVcLog::Log(2, m, __VA_ARGS__) #define LOG_ERROR(m, ...) CVcLog::Log(3, m, __VA_ARGS__) #endif // VC_LOG_H此设计强制开发者在每条日志前声明模块名如NetClient、DBEngine避免日志混杂难追溯级别参数nLevel为整数而非枚举因 VC6 不支持强类型枚举enum class且整数便于后续扩展条件过滤如if(nLevel 2) WriteToConsole()。...可变参数经va_list处理与printf行为一致降低学习成本。2.3 初始化与线程安全临界区替代std::mutex的 VC6 实现VC6 无mutex头文件CRITICAL_SECTION是唯一可靠的用户态同步原语。初始化函数Init()必须在CWinApp::InitInstance()早期调用且需显式初始化临界区// vc_log.cpp #include vc_log.h CStdioFile* CVcLog::m_pLogFile NULL; CRITICAL_SECTION CVcLog::m_csLog; DWORD CVcLog::m_dwMaxFileSize 1024*1024; int CVcLog::m_nMaxBackupFiles 5; CString CVcLog::m_strLogPath; BOOL CVcLog::m_bInited FALSE; BOOL CVcLog::Init(LPCTSTR lpszLogPath, DWORD dwMaxSize, int nMaxFiles) { if (m_bInited) return TRUE; // 创建临界区 InitializeCriticalSection(m_csLog); m_strLogPath lpszLogPath; m_dwMaxFileSize dwMaxSize; m_nMaxBackupFiles nMaxFiles; // 尝试打开日志文件追加模式 m_pLogFile new CStdioFile(); if (!m_pLogFile-Open(m_strLogPath, CFile::modeCreate | CFile::modeNoTruncate | CFile::modeWrite | CFile::typeText)) { delete m_pLogFile; m_pLogFile NULL; DeleteCriticalSection(m_csLog); return FALSE; } // 移动到文件末尾 m_pLogFile-SeekToEnd(); // 写入日志头 WriteLogHeader(); m_bInited TRUE; return TRUE; }关键点说明InitializeCriticalSection(m_csLog)必须在new CStdioFile之前调用防止Init()多次调用时临界区重复初始化CFile::modeNoTruncate确保文件存在时不截断CFile::modeWrite允许写入CFile::typeText启用文本模式自动处理\n→\r\nSeekToEnd()是必需步骤否则WriteString()会从文件开头覆盖写入。3. 日志写入与文件轮转时间戳格式、轮转触发逻辑与路径安全处理3.1 带毫秒精度的时间戳生成CTime与GetTickCount()的混合使用VC6 的CTime类不支持毫秒CTime::GetCurrentTime()最小单位为秒但GetTickCount()返回自系统启动以来的毫秒数。二者结合可构造高精度时间戳void CVcLog::WriteLogHeader() { if (!m_pLogFile) return; CTime t CTime::GetCurrentTime(); DWORD dwTick GetTickCount(); int nMilliSec dwTick % 1000; CString strHeader; strHeader.Format(_T([%04d-%02d-%02d %02d:%02d:%02d.%03d] --- Log Start ---\n), t.GetYear(), t.GetMonth(), t.GetDay(), t.GetHour(), t.GetMinute(), t.GetSecond(), nMilliSec); m_pLogFile-WriteString(strHeader); }此处dwTick % 1000获取毫秒部分虽存在跨分钟时GetTickCount()溢出风险约 49.7 天但在典型 MFC 桌面程序生命周期内单次运行数小时完全可靠。若需绝对精确可改用QueryPerformanceCounter()但 VC6 需手动链接winmm.lib增加部署复杂度故本方案取平衡。3.2 文件轮转触发逻辑大小检查、备份命名与旧文件清理轮转发生在每次Log()调用前检查当前文件大小是否超限void CVcLog::RotateLogFile() { if (!m_pLogFile || !m_bInited) return; // 获取当前文件大小 DWORD dwSize m_pLogFile-GetLength(); if (dwSize m_dwMaxFileSize) return; // 关闭当前文件 m_pLogFile-Close(); delete m_pLogFile; m_pLogFile NULL; // 生成备份文件名log.txt → log.txt.1, log.txt.1 → log.txt.2, ... CString strBaseName m_strLogPath.Left(m_strLogPath.ReverseFind(_T(.))); CString strExt m_strLogPath.Mid(m_strLogPath.ReverseFind(_T(.))); CString strBackupName; // 从最大编号开始逐级备份 for (int i m_nMaxBackupFiles; i 0; i--) { CString strOld, strNew; if (i m_nMaxBackupFiles) { strOld m_strLogPath; } else { strOld.Format(_T(%s.%d), strBaseName, i); } strNew.Format(_T(%s.%d), strBaseName, i 1); // 删除最旧的备份如果存在 if (i m_nMaxBackupFiles ::GetFileAttributes(strNew) ! 0xFFFFFFFF) { ::DeleteFile(strNew); } // 重命名log.txt.1 → log.txt.2, log.txt → log.txt.1 if (::GetFileAttributes(strOld) ! 0xFFFFFFFF) { ::MoveFile(strOld, strNew); } } // 重新打开主日志文件清空内容 m_pLogFile new CStdioFile(); if (!m_pLogFile-Open(m_strLogPath, CFile::modeCreate | CFile::modeWrite | CFile::typeText)) { delete m_pLogFile; m_pLogFile NULL; return; } }参数说明m_nMaxBackupFiles 5表示最多保留log.txt.1到log.txt.5五个备份strBaseName提取主文件名如app.log→appstrExt提取扩展名.log确保备份名格式统一::MoveFile()替代CFile::Rename()因后者在 VC6 中对长路径支持不佳。3.3 安全日志路径处理避免硬编码路径与权限失败直接写入C:\Program Files\MyApp\log.txt在 Windows Vista 会因 UAC 权限失败。正确做法是将日志存于用户目录// 在 Init() 调用前动态生成路径 TCHAR szPath[MAX_PATH]; ::GetEnvironmentVariable(_T(USERPROFILE), szPath, MAX_PATH); CString strLogDir szPath; strLogDir _T(\\MyApp\\Logs\\); // 创建目录递归 ::CreateDirectory(strLogDir, NULL); CString strLogPath strLogDir _T(app.log); CVcLog::Init(strLogPath);GetEnvironmentVariable(USERPROFILE)兼容 XP/2000/Vista返回当前用户配置文件路径如C:\Documents and Settings\UserName或C:\Users\UserName规避权限问题。CreateDirectory()的第二个参数设为NULL表示使用默认安全描述符。4. 在 MFC 应用中集成与调试CWinApp初始化、TRACE替代方案与常见错误排查4.1 在CWinApp::InitInstance()中正确初始化日志系统必须在CMainFrame创建前完成日志初始化否则CMainFrame::OnCreate()中的日志可能丢失// MyApp.cpp BOOL CMyApp::InitInstance() { // 1. 初始化日志必须在 AfxOleInit() 之后CMainFrame 创建之前 CString strLogPath; TCHAR szPath[MAX_PATH]; ::GetEnvironmentVariable(_T(USERPROFILE), szPath, MAX_PATH); strLogPath.Format(_T(%s\\MyApp\\Logs\\app.log), szPath); ::CreateDirectory(strLogPath.Left(strLogPath.ReverseFind(_T(\\))), NULL); if (!CVcLog::Init(strLogPath)) { AfxMessageBox(_T(日志初始化失败请检查磁盘空间和权限。)); return FALSE; } // 2. 记录启动日志 LOG_INFO(_T(App), _T(Application started. Version: %s), _T(1.2.0)); // 3. 后续正常流程... CMainFrame* pFrame new CMainFrame(); m_pMainWnd pFrame; pFrame-LoadFrame(IDR_MAINFRAME); pFrame-ShowWindow(m_nCmdShow); pFrame-UpdateWindow(); return TRUE; }注意CVcLog::Init()返回FALSE时应给出明确提示而非静默失败。LOG_INFO宏在此处验证初始化成功形成闭环。4.2 替代TRACE宏在 Release 版本中保留关键日志TRACE仅在_DEBUG下生效Release 版本完全消失。CVcLog通过编译开关控制// vc_log.h 中追加 #ifdef _DEBUG #define DEBUG_LOG(m, ...) LOG_DEBUG(m, __VA_ARGS__) #else #define DEBUG_LOG(m, ...) /* 空定义Release 下不输出 */ #endif // 使用示例 void CMyDialog::OnBnClickedOk() { DEBUG_LOG(_T(UI), _T(OK button clicked. Input: %s), m_strInput); LOG_INFO(_T(Business), _T(Processing order ID: %d), m_nOrderId); }DEBUG_LOG仅在 Debug 构建中生效避免 Release 版本因调试日志影响性能LOG_INFO等则始终有效用于业务关键路径。4.3 常见错误与修复方案文件句柄泄漏、中文乱码与路径长度限制错误现象根本原因修复方案日志文件写入后内容为空或乱码CStdioFile::Open()未指定CFile::typeText导致二进制写入在Open()标志中强制添加CFile::typeText程序退出后日志文件被占用无法删除Uninit()未被调用CStdioFile对象未关闭在CWinApp::ExitInstance()中调用CVcLog::Uninit()中文日志显示为??源文件保存为 ANSI 编码但CStdioFile以 UTF-16 写入VC6 不支持 UTF-16必须将源文件保存为系统默认 ANSI如 GBK并确保 Windows 区域设置匹配CreateDirectory()失败路径含非法字符如*,?,或长度超MAX_PATH260 字符使用::GetLongPathName()转换长路径或缩短日志目录层级如MyApp\Logs而非MyApp\Debug\Logs\2024\06\Uninit()实现示例void CVcLog::Uninit() { if (m_pLogFile) { m_pLogFile-Close(); delete m_pLogFile; m_pLogFile NULL; } if (m_bInited) { DeleteCriticalSection(m_csLog); m_bInited FALSE; } }务必在CWinApp::ExitInstance()中调用int CMyApp::ExitInstance() { CVcLog::Uninit(); // 关键释放文件句柄和临界区 return CWinApp::ExitInstance(); }5. 进阶技巧控制台实时输出、日志级别动态切换与最小化内存占用优化5.1 同时输出到文件与控制台AllocConsole()与freopen()的 VC6 兼容用法为方便调试可在 Debug 版本中启用控制台输出// 在 Init() 中追加仅 Debug #ifdef _DEBUG if (AllocConsole()) { freopen(CONOUT$, w, stdout); freopen(CONIN$, r, stdin); SetConsoleTitle(_T(MyApp Debug Console)); LOG_INFO(_T(Console), _T(Debug console allocated.)); } #endif然后修改Log()函数在写入文件后追加控制台输出void CVcLog::Log(int nLevel, LPCTSTR lpszModule, LPCTSTR lpszFormat, ...) { if (!m_bInited) return; EnterCriticalSection(m_csLog); // ... [时间戳与格式化逻辑] ... // 写入文件 if (m_pLogFile) { m_pLogFile-WriteString(strLog); m_pLogFile-Flush(); // 立即刷盘避免缓冲区延迟 } // Debug 版本同时输出到控制台 #ifdef _DEBUG _tprintf(_T(%s), strLog); fflush(stdout); #endif LeaveCriticalSection(m_csLog); }freopen(CONOUT$, w, stdout)将stdout重定向到新分配的控制台_tprintf自动适配 Unicode/ANSIfflush(stdout)确保立即显示。5.2 动态调整日志级别运行时开关与配置文件读取通过读取 INI 文件实现级别控制避免重新编译// 在 Log() 开头添加 TCHAR szLevel[32]; ::GetPrivateProfileString(_T(Log), _T(Level), _T(1), szLevel, 32, _T(.\\config.ini)); int nMinLevel _ttoi(szLevel); // 0DEBUG, 1INFO, 2WARN, 3ERROR if (nLevel nMinLevel) { LeaveCriticalSection(m_csLog); return; }config.ini示例[Log] Level2 MaxFileSize524288 MaxBackupFiles3GetPrivateProfileString()是 Win32 APIVC6 原生支持无需额外依赖。5.3 内存占用极致优化静态缓冲区替代CString格式化频繁日志可能导致CString频繁分配/释放。改用固定大小栈缓冲区void CVcLog::Log(int nLevel, LPCTSTR lpszModule, LPCTSTR lpszFormat, ...) { // 使用 1024 字节栈缓冲足够大多数日志 TCHAR szBuffer[1024]; va_list args; va_start(args, lpszFormat); _vsntprintf(szBuffer, 1023, lpszFormat, args); // VC6 使用 _vsntprintf va_end(args); szBuffer[1023] _T(\0); // ... 后续时间戳拼接与写入逻辑 ... }_vsntprintf是 VC6 提供的安全版vsprintf自动截断避免溢出。1024 字节缓冲区在栈上分配零内存管理开销比CString的堆分配快 3~5 倍。注意_vsntprintf在 VC6 中需包含stdio.h且其行为与标准vsnprintf略有差异返回值为 -1 表示截断但在此场景下截断本身已是异常可忽略返回值。本文还有配套的精品资源点击获取