普贤教程 › 包参考

walk 包

递归目录遍历

项	值
包名	`walk`
版本	`0.2.0`
可用版本	`0.1.0 / 0.2.0`
入口	`walk.px`
分类	`文件系统`
文件数 / 行数	`1 / 103`

安装与引入

bash

pxpkg init          # 首次
pxpkg add walk@0.2.0
pxpkg install

import walk

所属分类教程：文件系统

公开接口

函数	参数
`wk_walk`	`root, max_depth=-1`

其余 6 个 def（内部与辅助，可直接调用但不属稳定接口）

函数	参数
`wk_join`	`root, name`
`wk_walk_rec`	`dir, depth, max_depth`
`wk_walk_files`	`root, max_depth=-1`
`wk_walk_dirs`	`root, max_depth=-1`
`wk_walk_ext`	`root, ext, max_depth=-1`
`wk_count`	`root, max_depth=-1`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/walk —— 递归目录遍历
------------------------------------------------------------
纯函数库（文件系统 IO，无全局状态），编译（px build）与解释（px run）双模式一致。
wk_walk(root, max_depth=-1) → Ok([{path, is_dir, size}]) | Err
每个目录内按名字排序（确定性）；首项为 root 本身。
max_depth：-1 不限；0 只 root；1 一层……（相对 root 深度）。
依赖：list_dir_opt（M184 安全变体）/ file_stat。
============================================================