slug: s2-02-zip title: ZIP支持库全套用法:压缩解压、追加目录、加密、读条目与删条目 summary: 覆盖 ZIP_ 前缀主要命令:压缩到ZIP、解压ZIP/单文件、添加文件目录字节集、删除条目、取列表与信息、是否加密、读文本/字节集,以及两种密码加密方式。 tags: ZIP支持库,压缩,解压,AES,条目 series: supportlib-s2 series_order: 2 type: tutorial
ZIP支持库全套用法:压缩解压、追加目录、加密、读条目与删条目
面板:支持库 → ZIP支持库 → ZIP压缩。命令统一前缀 ZIP_,扁平调用。
硬约束
- 包内路径一律用
/,不要用\。 - 密码非空默认 AES-256(加密方式=
2);ZipCrypto 用1。 ZIP_压缩到ZIP第 2 参可省略:写成源,, 递归, 密码(中间留空)。- 带密码的追加/删除会重建压缩包。
- 压缩级别:
-1默认,0仅存储,1..9deflate。 - 失败立刻看
ZIP_取最后错误()。 ZIP_解压ZIP会拒绝含../ 绝对路径的恶意条目。
窗口:按钮演示 编辑框日志(多行编辑框即可)
文本 g_根 = ""
文本 g_包 = ""
文本 g_出 = ""
函数 写日志(文本 s) {
编辑框日志.文本 = 编辑框日志.文本 + s + 换行符
}
函数 主窗口.创建完毕() {
g_根 = 取临时目录() + "\\ypp_zip_demo"
g_包 = g_根 + "\\demo.zip"
g_出 = g_根 + "\\out"
如果 (路径存在(g_根) == 假) {
创建目录(g_根)
}
写文件(g_根 + "\\a.txt", "第一行")
写文件(g_根 + "\\b.txt", "第二行")
创建目录(g_根 + "\\sub")
写文件(g_根 + "\\sub\\c.txt", "子目录")
编辑框日志.文本 = "演示目录:" + g_根
}
函数 按钮演示.单击(整数 X, 整数 Y) {
编辑框日志.文本 = ""
// ——— 1) 整目录压缩(可省略 zip 路径;这里指定路径)———
// 写法 A:无密码
如果 (ZIP_压缩到ZIP(g_根 + "\\a.txt", g_包) == 假) {
写日志("压缩失败:" + ZIP_取最后错误())
返回 ()
}
写日志("已压单文件 → " + g_包)
// 写法 B:目录 + 递归 + 密码 AES(加密方式默认 2)
文本 加密包 = g_根 + "\\enc.zip"
如果 (ZIP_压缩到ZIP(g_根, 加密包, 真, "123456", 2, -1) == 假) {
写日志("加密压缩失败:" + ZIP_取最后错误())
} 否则 {
写日志("加密目录包:" + 加密包 + " 是否加密=" + 到文本(ZIP_是否加密(加密包)))
}
// 写法 C:省略 zip 路径(自动生成在源旁)
// ZIP_压缩到ZIP(g_根 + "\\b.txt",, 真)
// ——— 2) 追加:文件 / 目录 / 字节集 ———
如果 (ZIP_添加文件(g_包, g_根 + "\\b.txt", "docs/b.txt") == 假) {
写日志("添加文件失败:" + ZIP_取最后错误())
} 否则 {
写日志("已追加 docs/b.txt")
}
如果 (ZIP_添加目录(g_包, g_根 + "\\sub", "sub", 真) == 假) {
写日志("添加目录失败:" + ZIP_取最后错误())
} 否则 {
写日志("已追加目录 sub/")
}
字节集 raw = 到字节集("from-bytes")
如果 (ZIP_添加字节集(g_包, raw, "mem/payload.bin") == 假) {
写日志("添加字节集失败:" + ZIP_取最后错误())
} 否则 {
写日志("已追加 mem/payload.bin")
}
// ——— 3) 查询条目 ———
写日志("条目数=" + 到文本(ZIP_取条目数(g_包)))
文本 列表[] = ZIP_取条目列表(g_包)
文本 项 = ""
遍历 (项, 列表) {
写日志("· " + 项)
如果 (ZIP_条目是否存在(g_包, 项)) {
写日志(" 信息:" + ZIP_取条目信息(g_包, 项))
}
}
// ——— 4) 直接读包内(不解压整包)———
文本 t = ZIP_读文本(g_包, "docs/b.txt")
写日志("读文本 docs/b.txt => " + t)
字节集 bb = ZIP_读字节集(g_包, "mem/payload.bin")
写日志("读字节集长度=" + 到文本(字节集长度(bb)))
// ——— 5) 解压:整包 / 单文件 ———
如果 (路径存在(g_出)) {
删除目录(g_出, 真)
}
创建目录(g_出)
如果 (ZIP_解压ZIP(g_包, g_出, 真) == 假) {
写日志("整包解压失败:" + ZIP_取最后错误())
} 否则 {
写日志("整包已解到 " + g_出)
}
文本 单出 = g_出 + "\\only-b.txt"
如果 (ZIP_解压文件(g_包, "docs/b.txt", 单出, 真) == 假) {
写日志("单文件解压失败:" + ZIP_取最后错误())
} 否则 {
写日志("单文件解压 => " + 单出)
}
// 加密包解压必须带密码
文本 加密出 = g_根 + "\\out_enc"
如果 (路径存在(加密出) == 假) {
创建目录(加密出)
}
如果 (ZIP_解压ZIP(加密包, 加密出, 真, "123456") == 假) {
写日志("加密包解压失败:" + ZIP_取最后错误())
} 否则 {
写日志("加密包已解到 " + 加密出)
}
// ——— 6) 删除条目 ———
如果 (ZIP_删除条目(g_包, "mem/payload.bin") == 假) {
写日志("删条目失败:" + ZIP_取最后错误())
} 否则 {
写日志("已删除 mem/payload.bin,剩余条目=" + 到文本(ZIP_取条目数(g_包)))
}
写日志("—— 演示结束 ——")
}
命令速查(本篇都用到了)
| 命令 | 作用 |
|---|---|
ZIP_压缩到ZIP |
文件/目录打成包;可省略路径、可加密 |
ZIP_解压ZIP |
整包解出 |
ZIP_解压文件 |
只解一个包内文件 |
ZIP_添加文件 / ZIP_添加目录 / ZIP_添加字节集 |
追加 |
ZIP_删除条目 |
删包内路径(重建包) |
ZIP_取条目列表 / ZIP_取条目数 / ZIP_取条目信息 |
查询 |
ZIP_条目是否存在 / ZIP_是否加密 |
判断 |
ZIP_读文本 / ZIP_读字节集 |
不解压直接读 |
ZIP_取最后错误 |
失败原因 |
对照:ZIP支持库