
第一次使用
安装并打开「Excel转CSV」,进入「操作」页。
在第一行「Excel文件夹」点击「选择」,选择存放工作簿的文件夹。也可以把一个文件夹拖入该行,或手动输入绝对路径后点击「加载文件」。
在第二行「CSV文件夹」选择一个已经存在的输出文件夹。请确保有写入权限和足够空间;输入和输出可以在同一个文件夹中,原 Excel 文件不会修改。
如需处理下级目录,打开「包含子文件夹」。选择新输入目录或切换开关后会自动加载文件。
核对文件列表,点击「开始转换」。插件按列表顺序逐个处理,单个文件失败后会继续处理后面的文件。
查看「成功」「失败」数量。失败项可以展开「详情」或悬停查看原因,再到 CSV 文件夹取出结果。
页面只有操作页,没有额外的配置页或内置教程页。文件夹路径、子文件夹开关和每页数量由工具箱保存,下次打开会恢复并重新扫描;转换进度不会跨重启恢复。
文件与目录规则
多工作表工作簿会导出全部工作表,包括隐藏表;每张表分别导出一个 CSV。空表仍生成带 UTF-8 编码标记的空 CSV。工作表名称中的 Windows 非法字符会替换为下划线,末尾空格和句点会去除,CON 等系统保留名称会加下划线前缀。
只加载 .xls、.xlsx,不区分扩展名大小写。Excel 正在打开时产生的 ~$ 临时文件不会加入列表。符号链接和目录联接不参与递归扫描,防止意外扫描到所选目录之外。
暂停、返回和列表
「暂停」在当前文件处理结束后生效,其余文件显示「已暂停」;点击「继续」接着处理。
转换期间不能修改输入输出目录、重新加载、移除文件或清空列表。
点击右上角「返回」或切换插件时,工具箱会在有任务的情况下确认是否中止。确认离开后停止后续转换,正常取消会清理当前工作簿尚未完成的结果;已经完成的工作簿保留。
解析一个较大的工作簿时,中止可能需要等待当前解析返回。强制结束整个软件或断电无法保证临时文件清理完成。
点击「总文件数」「等待中」「成功」「失败」可以筛选显示对应状态。筛选只影响显示,点击「开始转换」仍处理整个列表中的文件。
点击列表中的文件名可复制相对路径。列表支持分页、跳页和每页数量调整;筛选时自动返回第一页。
「移除」只从本次列表中移除该文件,「清空」清空整个列表,均不删除源文件或已经导出的 CSV;重新「加载文件」会再次扫描并显示它们。
右上角「置顶」控制工具箱窗口是否保持在其它窗口之上。
CSV 内容规则
结果固定使用 UTF-8 BOM、英文逗号分隔、CRLF 换行。单元格里含逗号、双引号或换行时会按 CSV 规则加引号,内部双引号写为两个双引号。中文、文本内容、数值 0 和布尔值都会保留;布尔值输出为 TRUE / FALSE。
CSV 只保存单元格值,不保存字体、颜色、列宽、图片、合并样式或宏。数字导出其存储值,不保留货币、百分比等显示格式;作为文本保存的前导零会保留。日期输出为 YYYY-MM-DD,含时间时使用 ISO 日期时间。用 Excel 再次打开 CSV 时,Excel 可能自动把长数字或前导零文本识别为数字,必要时使用 Excel 的文本导入功能并指定列类型。
公式只导出工作簿里已保存的计算结果,不重新计算,也不运行宏;没有缓存结果的公式单元格导出为空。如结果不正确,请先用 Excel 重新计算并保存原工作簿,再转换。
重名与失败处理
本插件不会覆盖已有 CSV。重复转换到同一个目录时,已有的目标文件会使对应工作簿失败;可选择新的输出目录,或自行移动旧结果后重试。同名 .xls / .xlsx 或不同工作表名称清理后产生相同 CSV 路径时,同样按重名处理。一个工作簿的所有目标会先检查;正常转换失败时回退本次为该工作簿写出的文件,不删除之前的结果。
单个源文件上限为 64 MB。两种格式均需要在内存中解析,压缩后的 XLSX 大小不能直接反映所需内存;包含大量单元格、图片或格式的文件仍可能超出工具箱的独立进程资源限制,请拆分后再试。
不支持密码保护工作簿、.xlsm、.xlsb,或仅把 CSV/HTML/XML 改成 .xls 后缀的文件。遇到格式错误,请先在 Excel 中另存为标准 .xlsx。遇到目录不可写、文件被占用或磁盘已满,请处理相应原因后重新加载并转换。
如需反馈错误,请同时提供失败项的详细信息和工具箱统一 error.log 中对应时段的记录,注意移除其中不便分享的文件路径。