简介这是一份面向C#初学者与桌面应用开发者的实用型WinForm工具资源解决日常文件管理中临时文件、日志等周期性冗余数据的自动清理难题。资源包含可直接双击运行的exe程序含6个可执行文件、完整VS解决方案.sln/.csproj及全部源码8个核心.cs文件支持自定义删除间隔天数、指定目标路径、按最后修改时间筛选过期文件并提供操作日志与异常捕获机制兼顾安全性与易用性。压缩包共49个文件涵盖编译产物exe/pdb、配置文件config/ini、界面资源resx/resources、调试缓存cache/suo/vsidx等结构清晰便于学习调试整体仅155KB轻量易部署。目前已有197人下载学习读者可快速掌握System.Threading.Timer定时任务调度、Directory/File文件系统操作、WinForm界面交互设计等关键技能并基于源码二次定制如增加文件类型过滤、回收站替代删除、多路径批量处理等功能。 做运维的朋友、写上位机的同行、乃至平时只是用电脑办公的同事应该都遇到过同一件事磁盘里堆满了日志、临时文件、下载缓存一清理就是几十分钟不清理就看着C盘变红。后来我写了一个C# WinForm小工具专门做定时自动删除文件可以设置多少天清理一次、只删多少天之前的文件编译成exe之后放到Windows上双击就能跑源码也一起整理了。这篇文章就把整个项目的设计思路、核心代码、打包发布和踩坑记录都写出来给有同样需求的朋友参考。先说明这个工具适合谁开发或运维人员、需要长期跑在生产环境或测试环境的机器、想给公司内网做一个小型文件清理工具但不打算引入复杂框架的团队。你不需要会很高深的技术掌握基础C#语法就能读懂改懂。要跑起来一台装了Windows的电脑加一个Visual Studio就够没有的话直接拿编译好的exe也能用。1. 项目拆解与功能规划先想清楚三个关键参数1.1 核心需求定时、按天、自动删除三个维度不能少标题说“定时自动删除文件”这句话包含三个信息定时、删除、文件。但真正落地时需要拆成几个参数执行频率多久触发一次清理动作按天、按小时还是每天固定时间文件匹配规则删哪些目录下的哪些文件比如*.log、*.tmp、所有文件保留天数删除多久之前修改过的文件这是最重要的安全阀很多人第一次写这类工具只做一个“删除”结果把当前正在使用的文件或重要数据也删了。我的建议是哪怕只是给自己用的小工具也要把这三个参数全部暴露出来宁可配置复杂一点也不能让程序自作主张。有人会问为什么不直接用Windows计划任务WinForm的优势在于“有界面”。计划任务适合一次性脚本或极简逻辑但它对非技术人员不友好很多人拿到exe不知道怎么设置每次执行还弹黑色窗口配置改动也不直观。而一个带界面的小工具可以直接看到“下次执行时间”“上次清理了多少文件”也能在界面上增删目录、修改天数改完保存配置下次启动自动加载。这对使用者来说是最友好的。1.2 为什么选WinForm而不是控制台或服务选型这件事不同人有不同理由我说一下实际考量。用控制台程序也可以实现定时任务但控制台窗口挂在桌面上很碍眼最小化又容易被误关。把它注册成Windows服务也不是不行但服务开发、调试、部署都比普通程序麻烦对一个几十KB的小工具来说性价比太低。WinForm是中间态有一个常驻窗口任务跑在后台用户打开一看就明白状态关掉窗口程序就退出也符合普通工具的使用直觉。如果你做的不是这种双参数清理工具而是简单的每日备份清理用计划任务也许更合理。但既然要做成“拿到就能用”的exeWinForm是更稳妥的选择。1.3 功能模块怎么划分我把整个工具拆成四个模块配置管理负责保存和加载清理任务包括目录、文件匹配模式、保留天数、执行时间定时调度内置一个常驻计时器到点触发清理流程文件清理遍历目录匹配文件按最后修改时间判断是否需要删除界面交互展示执行状态、任务列表、手动触发清理按钮模块划分的目的是方便调试和扩展。比如以后想加“删除到回收站”功能只需要改文件清理模块不影响其他部分。代码结构上我会单独建一个Config.cs、一个FileCleaner.cs界面逻辑只放在Form1.cs里这样任何一个文件都能独立改、独立测。2. 定时器选型与清理规则原理和取舍都要搞明白2.1 WinForm里的三种Timer怎么选很多人第一次写WinForm定时任务直接在工具箱拖了一个Timer就开始了。但如果程序要长时间运行Timer选型会直接影响可靠性。WinForm下常见的有三种定时器类型运行线程是否依赖UI消息循环适用场景System.Windows.Forms.TimerUI线程是界面同步更新、分钟级任务System.Threading.Timer线程池否后台长任务、高精度任务System.Timers.Timer线程池否服务端定时任务、需AutoReset配置System.Windows.Forms.Timer的Tick事件在UI线程上执行操作界面控件很方便但缺点是不够精确如果界面卡顿定时也会被延误。System.Threading.Timer基于线程池回调在后台线程执行适合长时间运行的后台任务但要注意在回调里不能直接操作界面控件得通过Invoke回到UI线程。System.Timers.Timer是封装了事件机制的定时器默认也在线程池上跑可以设置AutoReset属性控制是否循环触发。我在这个项目里用了System.Windows.Forms.Timer原因很简单工具的检查周期是分钟级的对毫秒级精确度没有要求而且整个程序本来就要常驻界面UI消息循环不会因为短任务卡住。但是如果你把检查间隔设到1秒以内或者程序里还有大量IO操作建议改用System.Threading.Timer并配合Invoke更新界面。2.2 “多少天执行一次”和“删多少天前的文件”不是一回事很多人会混淆这两个概念我举个例子说明。假设今天是2025年1月10日配置如下执行频率每3天执行一次保留天数30天那么程序会在1月3日、1月6日、1月9日、1月12日检查每次检查时把最后修改时间早于2024年12月11日的文件删掉。2024年12月11日就是DateTime.Now.AddDays(-30)。关键问题是按文件创建时间、最后修改时间还是最后访问时间我的建议是默认按LastWriteTime最后写入时间。在日志场景里创建时间通常只是文件诞生的时间但一个日志文件可能被多个进程持续写入很长时间最后写入时间才能真正反映“这个文件是不是还在被使用”。对于临时文件按最后修改时间删也更安全——一个文件如果30天都没被碰过基本可以判定是垃圾文件。代码里可以这样取时间var cutoff DateTime.Now.AddDays(-task.KeepDays); var info new FileInfo(file); if (info.LastWriteTime cutoff) { File.Delete(file); }三种时间属性的选择我也整理了一下LastWriteTime最后写入时间默认使用CreationTime创建时间适合按批次归档的场景LastAccessTime最后访问时间适合缓存清理但NTFS可能因为系统配置不会及时更新这个属性所以慎用2.3 线程安全与删除的幂等性定时触发时如果上一轮还没执行完下一轮又触发了就会出现重复扫描。我的做法是加一个标志位private bool isRunning false; private void RunClean() { if (isRunning) return; isRunning true; try { // 执行清理 } finally { isRunning false; } }这个简单的锁能避免很多尴尬情况。我遇到过清理一个有几万个文件的目录扫描加删除用了五六分钟如果没有标志位下一次定时触发会直接叠加上去导致两个线程同时删文件出现“文件不存在”的异常刷屏。删除操作本身要考虑幂等性文件在枚举时存在删除时可能已经被别的程序删了。所以任何File.Delete都要包在try-catch里捕获FileNotFoundException后直接跳过不需要当作错误处理。这一点非常关键后面在常见问题里还会再讲。3. 核心代码实现与界面搭建跟着可以直接改3.1 主界面布局怎么设计我用的是Visual Studio 2022目标框架选.NET Framework 4.6.2原因是Windows 10和11自带这个运行时编译出的exe放到用户机器上不需要额外安装任何东西真正做到双击即可使用。如果你自己电脑上有Visual Studio默认会带目标包也可以用.NET 8做但发布方式我会单独讲。界面从上到下分四块顶部清理任务列表DataGridView每一行是一个目录配置中部添加、删除、编辑任务按钮下部全局设置包括检查间隔、默认保留天数、启动时是否自动执行底部日志区域TextBox多行只读显示执行结果DataGridView的列我设计了六列目录路径、文件匹配模式、保留天数、是否递归、上次执行时间、状态。这样每个任务一目了然。界面不需要复杂的美化默认控件已经够用如果你想要更现代一点的风格可以用FlatStyle改成Flat或者引入一些开源美化组件但核心功能优先。3.2 配置的保存与加载配置如果只存在内存里重启就丢了所以要序列化到本地文件。我用的是JSON格式配合Newtonsoft.Json库。考虑到目标机器上不一定有环境程序设置成“首次启动时如果配置不存在就生成默认配置”保证不会因为缺失配置而崩溃。一个清理任务的实体类定义如下public class CleanTask { public string DirectoryPath { get; set; } public string FilePattern { get; set; } *.log; public int KeepDays { get; set; } 30; public bool Recursive { get; set; } true; }配置类如下public class AppConfig { public ListCleanTask Tasks { get; set; } new ListCleanTask(); public int CheckIntervalMinutes { get; set; } 30; public bool AutoRunAtStartup { get; set; } false; public DateTime LastRunTime { get; set; } public bool DryRun { get; set; } true; }保存和加载的代码比较简单我直接贴出来public static void SaveConfig(AppConfig config, string path) { string json JsonConvert.SerializeObject(config, Formatting.Indented); File.WriteAllText(path, json); } public static AppConfig LoadConfig(string path) { if (!File.Exists(path)) { return new AppConfig(); } string json File.ReadAllText(path); return JsonConvert.DeserializeObjectAppConfig(json); }配置文件路径用Application.StartupPath而不是写死当前目录这样即使从其他位置启动exe也能找到配置。另外如果程序是用管理员权限运行的配置文件最好也放在程序目录否则在某些受保护目录下可能没有写入权限。3.3 定时与清理的主逻辑主窗体的Timer事件里每次检查当前时间与LastRunTime的间隔如果超过设置的间隔就执行清理。这样设计有一个好处即使程序在前一天运行的时候刚好断电、没触发定时下一次启动后检查会发现已经超过间隔自动补跑一次清理不用干等下一个周期。核心代码如下private void timer_Tick(object sender, EventArgs e) { if (config.LastRunTime DateTime.MinValue || DateTime.Now - config.LastRunTime TimeSpan.FromMinutes(config.CheckIntervalMinutes)) { ExecuteClean(); } }ExecuteClean里的主要步骤private void ExecuteClean() { if (isRunning) return; BeginInvoke((MethodInvoker)(() SetStatus(正在清理...))); isRunning true; try { int totalDeleted 0; long totalFreedBytes 0; foreach (var task in config.Tasks) { if (!Directory.Exists(task.DirectoryPath)) { AddLog($[跳过] 目录不存在: {task.DirectoryPath}); continue; } var cutoff DateTime.Now.AddDays(-task.KeepDays); var options task.Recursive ? SearchOption.AllDirectories : SearchOption.TopDirectoryOnly; var files Directory.GetFiles(task.DirectoryPath, task.FilePattern, options); foreach (var file in files) { try { var fi new FileInfo(file); if (fi.LastWriteTime cutoff) { long size fi.Length; File.Delete(file); totalDeleted; totalFreedBytes size; } } catch (FileNotFoundException) { // 文件已经被其他进程删除正常跳过 } catch (IOException ex) { AddLog($[警告] 删除失败: {file}, {ex.Message}); } catch (UnauthorizedAccessException ex) { AddLog($[警告] 无权限删除: {file}, {ex.Message}); } } } config.LastRunTime DateTime.Now; SaveConfig(); AddLog($清理完成共删除 {totalDeleted} 个文件释放 {totalFreedBytes / 1024.0 / 1024.0:F2} MB); } finally { isRunning false; } }这里有一个细节计算释放空间时我在删除之前先取了fi.Length。文件如果被其他进程锁定File.Delete会抛IOException但已经在try-catch里处理了。另外Directory.GetFiles方法会一次性把所有文件加载到内存如果目录下有几十万个文件内存占用会偏高。这种情况下可以先Directory.EnumerateFiles用迭代器逐个处理但一般清理场景用GetFiles就够了代码也更好理解。3.4 界面线程与后台线程的协作虽然System.Windows.Forms.Timer的Tick事件在UI线程执行但文件扫描和删除是耗时操作如果目录里文件很多UI会被堵死窗口无法拖动按钮点了没反应。解决方案是把真正耗时的部分放到后台线程执行等完成后再用Invoke更新界面。我的实现是在Timer的Tick事件里启动一个Task.Run这样UI线程立即返回界面不会卡private void timer_Tick(object sender, EventArgs e) { if (DateTime.Now - config.LastRunTime TimeSpan.FromMinutes(config.CheckIntervalMinutes)) { Task.Run((Action)ExecuteClean); } }Task.Run里执行ExecuteClean里面所有用到界面控件的操作我都先用BeginInvoke或Invoke。BeginInvoke是异步的不会阻塞后台清理线程Invoke是同步的如果界面卡顿清理线程也会跟着等。日志量不大的情况下两者区别不大我习惯用BeginInvoke。还有一点程序退出时要释放定时器并保存配置。在FormClosing事件里加上timer.Stop()和SaveConfig()。如果程序被任务管理器强杀配置可能没有保存所以我会把LastRunTime这类关键信息在每次清理结束后立即保存而不是只在退出时保存。4. 编译打包与双击即用发布成exe的实操指南4.1 开发环境与目标框架选择我强调过选.NET Framework 4.6.2是为了减少运行时依赖。但如果你用.NET FrameworkVisual Studio 2022默认模板不一定直接有WinForm项目模板需要先安装“.NET桌面开发”工作负载。创建项目时选“Windows窗体应用(.NET Framework)”框架版本选4.6.2或更高。如果你更喜欢.NET 6/8代码逻辑完全一样只是发布方式不同。.NET 6/8默认是依赖框架运行目标机器上如果没有装.NET运行时双击exe会报错。解决办法是发布时选“自包含”把运行时一起打包进exe但体积会大很多。我实测一个最简单的WinForm清理工具自包含发布后大约70MB而.NET Framework版本只要几百KB。对于这种小工具默认用.NET Framework最省事。4.2 发布成单个exe的两种方式先说.NET Framework方式。默认编译生成的exe依赖.NET Framework而Windows 10/11自带所以直接把bin\Release目录下的exe拷走就能用。如果你的程序还用到了第三方库比如Newtonsoft.JsonRelease目录下会多出对应的dll拷贝的时候记得一起拷。如果不想带一堆dll可以用NuGet里的“Costura.Fody”插件或者在项目属性里设置“生成单个文件”。不过WinForms项目使用单文件发布需要留意有些第三方库在单文件模式下路径会变化可能读取不到配置。稳妥起见我把配置文件和exe放在同一目录读取配置都用Application.StartupPath这样不管怎么发布都不会出问题。再说.NET 8方式。在Visual Studio里右键项目选择“发布”配置时选“生成单个文件”和“启用ReadyToRun编译”目标框架选win-x64部署模式选“自包含”。发布完成后会得到一个exe体积大但好处是目标机器不用装任何环境双击就用。如果你的用户都是内网电脑不能随便装运行时这个方式最省心。4.3 打包后第一次运行会遇到的坑打包成exe后有几个实际遇到的坑分享出来第一杀毒软件可能误报。用.NET Framework编译的小exe有时候会被某些杀毒软件当成未知程序。解决办法是代码签名或者加白名单。自己用无所谓如果是给公司同事用建议用公司证书签名或者提供一个校验值。第二配置文件受“以管理员身份运行”影响。如果你的程序必须用管理员权限删除某些系统目录下的文件可以在app.manifest里设置requestedExecutionLevel levelrequireAdministrator。但要注意提升权限后程序的工作目录可能会变成System32此时Application.StartupPath依然指向exe所在目录所以读取配置一定要用它而不是Environment.CurrentDirectory。这一步能避免很多“配置怎么突然失效了”的问题。第三目标机的位数问题。默认AnyCPU编译在没有特殊依赖时大多数都能跑但如果目标机器是纯64位且没有32位兼容层程序可能会启动失败。建议直接编译成x64或x86根据实际环境选择别用AnyCPU偷懒。5. 常见问题与排查技巧实战踩坑记录5.1 定时器为什么没触发或延迟最典型的原因是程序没有一直运行。很多用户把窗口最小化后以为程序还在跑实际上如果你关闭了主窗口进程就退出定时自然失效。一个补救措施是“最小化到托盘而不是退出”在FormClosing里改成“最小化并隐藏”这样用户以为关了其实还开着。不过这个行为要在界面上明确提示否则用户会奇怪“程序怎么还在跑”。第二个原因是电脑睡眠。Windows在睡眠状态下任何Timer都不会执行等唤醒之后Timer的Tick才会继续触发。我设计里用LastRunTime判断间隔可以保证唤醒后立即补跑清理不需要等到下一个整点。这一点非常重要特别是你设置了“每天凌晨执行”但电脑晚上睡眠早上唤醒后就会执行。第三个原因是Timer的Interval设太小与系统负载冲突。例如设成1秒然后清理过程又要跑几分钟虽然加了isRunning锁但Tick还是会不断触发只是进入方法后立即返回白白消耗资源。把Interval设在30秒到5分钟之间比较合适。5.2 文件删不掉甚至弹“访问被拒绝”这个问题分两层权限不足和文件占用。权限不足如果你清理的是C:\Windows\Temp或ProgramData下的目录普通权限确实不够。解决办法是用管理员身份运行exe。代码层面可以在app.manifest里设置requireAdministrator但这样每次启动都弹UAC框体验一般。可以做成“普通模式先跑遇到无权限目录时提示是否以管理员身份重启”但这个逻辑会复杂一些我目前是直接要求用户以管理员身份运行。文件占用很多临时文件正在被其他进程打开。File.Delete会抛IOException无法强制删除。遇到这种情况不要硬删记录日志跳过即可。如果你想更彻底可以在重启后再清理一次但没必要在工具里做强制结束进程这种事风险太大。5.3 文件删除后又被创建是怎么回事这个不是bug是程序本身还在运行并且持续产生新文件。比如你清理了一个正在写日志的程序的文件目录刚删完那个程序又创建了新文件日志记录自然继续增长。所以在设计清理策略时要跟目标程序的运行状态配合如果目标程序是服务最好在服务低峰期清理如果目标程序有日志归档机制清理工具的保留时间应该比归档周期长否则会出现归档还没完成、日志就被删了的情况。5.4 误删文件的防线“定时自动删除”最怕的就是误删。我的防线有三层第一默认保留天数不要设成0。0代表“删除所有匹配文件”这是危险配置。我在代码里做了限制KeepDays 0时按1天处理并打日志提示。第二文件匹配模式不要写成*。如果目录下还有其他类型的数据文件全删了很难恢复。界面上默认显示*.log、*.tmp、*.bak这种明确模式用户改成其他模式需要二次确认。第三增加“模拟运行”模式。在配置里打开DryRun开关开启后只列出会删除的文件列表不真正删除。建议第一次配置目标目录时先开启模拟运行跑几天确认不会误删再关闭。这个功能代码量很小但价值极高。if (config.DryRun) { AddLog($[模拟] 将删除: {file}); continue; }就这一小段能救回很多重要文件。5.5 日志与执行记录的留存建议工具把每次清理结果写入一个本地的cleaning.log文件。这样即使窗口关闭、信息刷过去了也能事后审计。日志内容至少包括时间、任务目录、删除文件数量、释放空间、失败文件数。如果以后需要调查“某个文件为什么没了”这个日志就是唯一线索。写入日志时我是用File.AppendAllText注意多线程同时写可能冲突所以日志写入方法也要加锁或者统一在UI线程里写。我采用的是统一收集后批量写避免频繁打开文件句柄。这里整理一个常见问题速查表现象可能原因解决方案定时不触发程序被关闭、电脑睡眠最小化到托盘、唤醒后补跑文件删除失败文件被占用、权限不足跳过并记录日志、管理员身份运行删除后文件还在增长目标程序持续写文件错开业务高峰、保留时间大于归档周期配置保存失败管理员模式下工作目录变化使用Application.StartupPath定位配置6. 扩展方向与长期使用心得6.1 值得加的几个功能扩展做完基础版之后还能往几个方向扩展最小化到托盘。用NotifyIcon组件点击关闭按钮时隐藏主窗体而不是退出托盘图标可以显示“上次清理时间”的提示。这个功能对长期运行很有用用户不会误关又不至于任务栏常驻一个窗口。开机自启动。把exe路径写入注册表HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run或者放一个快捷方式到启动文件夹。注意不要要求管理员权限也能写入当前用户注册表。清理结果通知。用MailKit发邮件或者调用企业微信机器人webhook适合无人值守的服务器环境。公司里如果有一台常开的机器定期清理日志清理完成后发一条消息到工作群大家就不用反复确认“日志到底清了没有”。按文件大小过滤。在CleanTask里加一个MinSizeMB字段只删超过指定大小的文件。这个需求在清理视频缓存、下载缓存时很常见小文件即使很旧也可能有用大文件才值得优先清理。多配置文件切换。不局限于一个全局配置可以给不同目录组命名比如“临时文件组”和“日志组”界面上一个下拉框切换方案。这样不同清理策略互不干扰也不用来回改参数。6.2 个人使用心得与最终提醒我个人在实际使用中还有一个习惯把“清理昨天之前的文件”和“清理N天之前的文件”分开。前者在业务上更安全比如日志文件按天滚动保留30天就写“删除30天前之前的文件”不要写成“删除修改时间大于30天的文件”这两种表达在边界当天会差一天虽然影响不大但可以在代码里统一用符号避免边界歧义。最后再分享一个小技巧如果你自己要长期用这个工具可以把配置目录指向一个网络共享路径UNC路径但要注意同一份清理配置在不同机器上运行可能重复清理同一个目录。建议只在一台机器上跑定时任务这台机器挂掉的话其他机器再顶上。我在公司就是这么做的一台常开的服务器负责清理日志目录其他开发机只配置“模拟模式”避免两边同时删文件产生竞态。这个项目的完整源码结构不复杂总共就三个文件Form1.cs、Config.cs、Program.cs加一个app.manifest。如果你打算自己改下载源码后直接打开sln文件编译即可如果你只是要用把我发布的exe放到一个固定目录第一次启动时配置好要清理的目录和天数之后就不用管了。配置这东西刚写的时候记得留一点余量宁可少删一点也不要因为设置过激把重要文件弄丢。这个工具的价值不在于它有多炫酷而在于它能日复一日地在后台帮你处理那些没人愿意手动做的事情稳定、可靠、不出事故——我觉得这才是这类小工具最该有的样子。本文还有配套的精品资源点击获取