zogo/filex/README.md

filex

文件与目录工具：工作目录/运行目录定位、路径存在性判断、带进度回调的文件下载、 Zip 打包与解压（兼容 GBK 编码的中文文件名）。

迁移自 go-hua/common（原 dir.go / path.go / downFile.go / zip.go）。

用法

import "git.zeroonesoft.cn/golib/zogo/filex"

// 目录定位
filex.GetWorkDir()             // os.Getwd()
filex.GetRunDir()              // 可执行文件所在目录（兼容 go run，尾带分隔符）
filex.GetCurrentAbPathByCaller()

// 路径存在性
exists, err := filex.PathExists("/path/to/x")

// 下载文件（fb 进度回调：总长度、已下载长度）
err := filex.DownloadFile("https://example.com/a.zip", "D:/tmp/a.zip",
    func(length, downLen int64) { ... })

// Zip 打包（目录或单文件）/ 解压（Flags==0 按 GB18030 解码文件名，兼容中文 zip）
err := filex.Zip("D:/data/src", "D:/tmp/src.zip")
err := filex.Unzip("D:/tmp/src.zip", "D:/data/out")

完整可运行例程：examples/filex/main.go

注意

• DownloadFile 跳过 TLS 证书校验（InsecureSkipVerify: true），下载超时 300s， 只支持 GET；不要用于对安全性敏感的场景。
• Zip 目录项名以 \ 结尾（历史行为，兼容易语言侧解压）；Unzip 已兼容 UTF-8 与 GBK 两种文件名编码。
• GetRunDir 在 go run（临时目录）场景回退到工作目录。