7-Zip 怎么用清单文件选择性打包并保留相对路径

需要把项目中的少数源码、文档和示例文件交给别人时，直接在命令行堆一长串路径很快就会失控。7-Zip 支持用 @listfile 读取清单文件：清单决定哪些文件进入归档，命令执行时的共同根目录则决定这些路径如何保留在归档内部。

本文只处理“清单文件 + 选择性打包 + 相对路径”这条链路，不讨论密码保护。7-Zip 官方地址：https://7-zip.org/。文中的界面图是原创静态说明图，用来帮助定位操作状态，不是 7-Zip 真实截图或运行证据。

最稳妥的做法是：把清单写成相对于项目根目录的路径，先切换到这个根目录，再执行 7z a archive.7z @filelist.txt。这样只会加入清单匹配的条目，归档内也不会带上本机的绝对盘符。

先确定清单相对于哪个目录

假设项目根目录是 D:\project，目录中有 src\main.go、docs\guide.txt 和 examples\readme.md。清单文件也放在这个根目录，内容只写要归档的路径或通配符，每行一个：

src\main.go
docs\guide.txt
examples\readme.md

这些行不是从当前用户目录解析，而是从执行 7-Zip 时的工作目录解析。为了让换电脑、换脚本仍然得到相同的内部结构，先把“共同根目录”定成 D:\project，不要把 D:\project 本身写进清单。

用 @listfile 选择性创建归档

准备好清单后，在同一个项目根目录打开命令行入口，使用 a 命令创建归档。清单文件前面的 @ 是关键，它告诉 7-Zip 后面的参数不是一个普通文件，而是“文件名列表”。

rem 切换到所有清单路径共同所属的项目根目录
cd /d D:\project

rem 只加入 filelist.txt 中列出的文件，并把结果写入 archive.7z
7z a -t7z archive.7z @filelist.txt

这里的 archive.7z 是目标归档，@filelist.txt 是输入清单。清单里没有出现的文件不会因为它们位于同一个项目目录中就自动加入。命令成功后，归档中的条目通常会显示为 src\main.go、docs\guide.txt 这样的相对路径。

如果一个目录下需要加入一组文件，可以在清单中写通配符，例如 src\*.go；如果要完整匹配所有文件，不要把 *.* 当成“所有文件”，7-Zip 的通配规则会把它理解为带扩展名的名称。

src\*.go
docs\guide.txt
examples\readme.md

中文文件名和空格路径怎么处理

7-Zip 命令行文档说明，清单文件默认按 UTF-8 读取。如果清单中含有中文文件名，优先把 filelist.txt 保存为 UTF-8，并保持命令行窗口和文件系统路径一致。若你的流程明确使用另一种编码，可以用 -scs 指定清单编码；不要一边改编码、一边把路径拆成多个参数。

rem 仍然从项目根目录执行，避免清单中的相对路径漂移
cd /d D:\project

rem 明确告诉 7-Zip 清单使用 UTF-8 编码
7z a -t7z archive.7z @filelist.txt -scsUTF-8

清单文件的职责是提供文件名或通配符，命令行本身的职责是提供归档名和开关。路径里有空格时，先把带空格的条目单独确认清单格式，再通过归档预览检查是否被当成一个完整路径；不要把一条路径拆成两行。

从归档预览确认选择范围

创建完成后，打开归档工具的预览区域，重点看两件事：第一，清单中列出的条目是否都出现；第二，条目是否以项目根目录下的相对结构呈现，而不是带有 D: 之类的本机前缀。下面的原创说明图表现了这两个验收状态。

如果归档中出现了不希望的文件，通常是清单里用了过宽的通配符；如果条目缺少上级目录，通常是执行命令时切换到了错误的工作目录，或清单本身只写了文件名。把共同根目录和清单行重新对齐后，再生成同名归档即可。

四个常见不生效原因

1. 工作目录不对：清单中的 src\main.go 是相对当前目录解析的。先用 cd /d D:\project 切到共同根目录，再执行归档命令。
2. 误用 *.*：7-Zip 不把它当成所有文件。要匹配没有扩展名的文件，应使用更合适的 * 或更具体的路径。
3. 清单编码不一致：中文路径乱码或找不到时，先统一保存为 UTF-8；只有确实需要时再用 -scs 指定编码。
4. 把绝对路径写进清单：绝对路径会让清单依赖某一台机器，也不利于复用。把它改写成相对于共同根目录的路径，并从该目录启动命令。

一张表记住排查顺序

相关问题

清单文件必须和归档放在同一目录吗？

不必须。清单可以写绝对位置或通过命令行提供路径，但为了让相对路径稳定，通常把清单放在共同根目录，并从该目录执行命令。

为什么归档里有一个多余的项目目录名？

检查清单是否写成了 project\src\main.go，以及执行命令时是否已经位于 D:\project。如果两处都把项目根目录算了一次，就会多出一层；保留一处即可。

能不能用清单文件排除某些文件？

本文的清单是“只列入需要的内容”模式，最清晰的排除方式是不要把不需要的文件写入清单。若规则更复杂，再单独研究 7-Zip 的包含和排除开关，避免把多种规则混在一个简单清单里。