合并 2023 年 1 月功能介绍与 2 月使用说明,适用原 macOS 版本。
Never 文件自由是一个用 Flutter 编写的 macOS 文件归档工具。它读取目录、按文件类型筛选条目,再生成移动命令供用户查看和执行。本文记录 2023 年 1 月至 2 月版本的功能与实现经验。
从目录到文件清单
源文件夹和目标文件夹各有独立输入区,支持点击「选择」打开目录选择窗口,也支持把文件夹拖进界面。
源文件夹选好后,点击「检索源文件地址目录」,程序列出目录及其子目录中的文件,并显示文件类型、文件名和路径。用户按类型选择需要归档的文件,再指定目标文件夹。
这一步的结果是一份可查看的清单。文件名和完整路径需要分别保留,因为不同子目录可能出现同名文件;仅凭文件名无法确定实际操作对象。
移动命令与重名处理
旧版点击「操作已选择文件」后,会生成命令行文本并复制到剪贴板。应用本身不执行这段移动命令,实际移动发生在用户将命令粘贴到终端执行之后。
早期版本提供是否保留重名文件的选项。2023 年 2 月的更新改为保留同名文件,并给重名项添加时间戳以作区分。这个规则解决的是生成清单中的命名问题;执行前仍需处理目标目录已经存在的同名文件,不能把时间戳视为无条件避免冲突的保证。
原项目面向 macOS,相关命令格式也按 macOS 编写。旧文章中的命令通过字符串拼接产生,文件路径中含引号等字符时需要额外处理。旧命令输出不适合直接用于重要目录。
按文件名排除条目
检索完成后,在文件列表中右键点击条目,选择「拉黑文件名」并确认,即可把该名称加入排除列表。

这项规则按文件名生效。同一目录树中所有使用该名称的文件,都会被后续检索和命令生成流程排除。它适合反复跳过固定名称的文件,但不能用来区分不同路径下的同名条目。
原版用 sqflite_common_ffi 保存排除记录,表中包含名称、添加时间等字段。持久化后,用户不必在每次检索时重复设置。右上方的「文件黑名单」入口用于查看已有记录,列表中的「移除」用于撤销排除。
Flutter 桌面交互的实现思路
原项目把目录选择、拖入和文件类型筛选分开实现。
| 功能 | 原项目使用的组件或方式 |
|---|---|
| 打开目录选择窗口 | file_picker 的 getDirectoryPath |
| 接收拖入的文件夹 | desktop_drop 的 DropTarget |
| 显示文件类别 | mime 的 MIME 类型识别 |
| 保存排除名单 | sqflite_common_ffi |
| 提交移动操作 | 生成文本,由用户在终端执行 |
拖入时,onDragEntered 和 onDragExited 改变接收区域的背景,onDragDone 接收路径并更新目录选择。取消目录选择窗口时,返回值可能为空,界面应保留原有选择。
文件系统对象类型与 MIME 类型需要分开判断。lookupMimeType 返回 null 仅表示未识别出 MIME 类型,不能据此认定路径是文件夹。目录识别可以使用 Dart 的 FileSystemEntity.type,并明确是否跟随符号链接。MIME 类型查询、文件系统类型查询
import 'dart:io';
Future<bool> isDirectory(String path) async {
final type = await FileSystemEntity.type(path, followLinks: false);
return type == FileSystemEntityType.directory;
}
这里的 followLinks: false 使符号链接保持为链接类型,不会把指向目录的链接当作普通目录接收。
若把文件操作改为应用内执行,可将可执行文件与参数列表分别传给 Process.run,避免把文件路径拼成一整段 Shell 文本。文件移动还要单独处理目标重名、权限、失败结果与跨文件系统等情况。Dart 的 File.rename 在目标文件已存在时会移除目标,并且在部分平台不能跨文件系统移动,调用方式必须与产品的重名策略一致。Process.run、File.rename
项目来源
作者:NeverOuO。功能介绍发表于 2023 年 1 月 14 日,使用说明发表于 2023 年 2 月 15 日。


