目录

• 工具简介
• 核心特性
• 核心用途与场景
• 常见报错与解决方案
• 适配开源鸿蒙 PC 端的要点
• 鸿蒙适配中的报错解决过程
• 构建脚本详解
• HNP 包配置
• 构建结果
• 仓库地址与安装方式
• 总结
• FAQ
• 相关链接

---

工具简介

tree 是一个用 C 语言编写的命令行工具，用于以树状结构递归显示目录内容。它可以将目录结构以可视化的方式展示，非常适合快速浏览文件系统结构。

什么是 tree？

tree 是一个轻量级的命令行工具，用于以树状格式显示目录结构。它递归遍历目录，并以缩进的方式展示文件和子目录的层次关系，使目录结构一目了然。

核心优势：

• 可视化目录结构：以树状格式展示目录层次
• 轻量级：单一可执行文件，依赖少
• 功能丰富：支持颜色、HTML、JSON、XML 等多种输出格式
• 跨平台：支持多种 Unix-like 系统

核心特性

1. 树状显示：

   • 递归显示目录结构
   • 使用缩进和连接符展示层次关系
   • 支持 ASCII 图形线条

2. 多种输出格式：

   • 文本格式：默认的树状文本输出
   • HTML 格式：生成 HTML 文件（-H 选项）
   • JSON 格式：生成 JSON 输出（-J 选项）
   • XML 格式：生成 XML 输出（-X 选项）

3. 颜色支持：

   • 根据文件类型自动着色
   • 支持 LS_COLORS 环境变量
   • 支持 CLICOLOR 和 CLICOLOR_FORCE 环境变量

4. 过滤和排序：

   • 支持模式匹配（-P 和 -I 选项）
   • 支持 .gitignore 文件（--gitignore 选项）
   • 支持多种排序方式（按名称、时间、大小等）

5. 信息显示：

   • 显示文件大小（-s 选项）
   • 显示文件权限（-p 选项）
   • 显示最后修改时间（-D 选项）
   • 显示用户和组（-u 和 -g 选项）

6. 深度控制：

   • 限制显示深度（-L 选项）
   • 只显示目录（-d 选项）
   • 只显示文件（-f 选项）

开发语言与设计优势

C 语言的优势：

• 性能：编译后的二进制文件运行速度快，资源占用低
• 可移植性：C 语言标准广泛支持，易于跨平台编译
• 轻量级：单一可执行文件，不需要额外的运行时库
• 简单直接：代码结构清晰，易于理解和维护

设计优势：

• 零依赖：除了标准 C 库外，不需要其他依赖
• 快速启动：启动速度快，适合频繁使用
• 资源占用低：内存和 CPU 占用小
• 易于集成：可以轻松集成到脚本和工具链中

---

核心用途与场景

基本用法

1. 显示目录树

# 显示当前目录的树状结构
tree

# 显示指定目录的树状结构
tree /path/to/directory

# 显示多个目录
tree dir1 dir2 dir3

2. 限制显示深度

# 只显示 2 层深度
tree -L 2

# 只显示 1 层深度
tree -L 1

# 显示指定深度的目录
tree -L 3 /usr/local

3. 只显示目录或文件

# 只显示目录
tree -d

# 只显示文件
tree -f

# 只显示目录，限制深度
tree -d -L 2

4. 显示文件信息

# 显示文件大小
tree -s

# 显示文件权限
tree -p

# 显示最后修改时间
tree -D

# 显示用户和组
tree -u -g

# 显示所有信息
tree -s -p -D -u -g

5. 过滤文件

# 只显示匹配模式的文件
tree -P "*.txt"

# 排除匹配模式的文件
tree -I "*.o|*.a"

# 使用 .gitignore 文件
tree --gitignore

# 排除多个模式
tree -I "node_modules|target|*.o"

6. 排序

# 按修改时间排序
tree -t

# 按大小排序
tree -S

# 按版本号排序
tree -v

# 反向排序
tree -r

# 文件优先
tree --filesfirst

# 目录优先
tree --dirsfirst

实际应用场景

场景 1：项目结构展示

# 显示项目目录结构
tree -L 2

# 排除构建目录
tree -I "target|build|node_modules"

# 显示项目结构并保存到文件
tree -L 3 -I "target|build" > project_structure.txt

场景 2：文档生成

# 生成 HTML 格式的目录树
tree -H . -o directory_tree.html

# 生成 JSON 格式的目录树
tree -J > directory_tree.json

# 生成 XML 格式的目录树
tree -X > directory_tree.xml

场景 3：系统管理

# 查看系统目录结构
tree -L 2 /etc

# 查看用户目录结构
tree -L 3 ~

# 查看安装的软件目录
tree -L 2 /usr/local

场景 4：代码审查

# 查看源代码结构
tree -I "*.o|*.a|target|build" src/

# 查看测试文件
tree -P "*test*" -P "*spec*"

# 查看配置文件
tree -P "*.conf|*.config|*.yaml|*.yml|*.json"

场景 5：磁盘空间分析

# 显示目录大小
tree -s -h

# 显示目录使用情况
tree -d -s -h

# 查找大文件
tree -s -h | grep -E "[0-9]+[MG]"

高级用法

1. 组合选项

# 显示目录树，包含大小和权限，限制深度为 3
tree -L 3 -s -p

# 显示目录树，排除构建文件，生成 HTML
tree -I "target|build|*.o" -H . -o output.html

# 显示目录树，按时间排序，只显示目录
tree -d -t

2. 输出重定向

# 保存到文件
tree > directory_tree.txt

# 追加到文件
tree >> directory_tree.txt

# 管道处理
tree | grep "\.txt$"

# 结合其他工具
tree -J | jq '.'

3. 环境变量

# 设置颜色
export CLICOLOR=1
export CLICOLOR_FORCE=1

# 使用 LS_COLORS
export LS_COLORS="di=1;34:fi=0:ln=1;36"

# 禁用颜色
export NO_COLOR=1

---

常见报错与解决方案

问题 1：安装失败

错误信息：

make: *** No rule to make target `install'. Stop.

原因：Makefile 未正确配置或缺少必要的变量。

解决方案：

# 检查 Makefile 是否存在
ls -la Makefile

# 查看 Makefile 配置
grep -E "PREFIX|DESTDIR|MANDIR" Makefile

# 手动设置变量并安装
make install PREFIX=/usr/local DESTDIR=/path/to/install

问题 2：权限错误

错误信息：

install: /usr/local/bin/tree: Permission denied

原因：尝试安装到系统目录，需要 root 权限。

解决方案：

# 使用 DESTDIR 安装到指定目录
make install DESTDIR=/path/to/install PREFIX=/usr

# 或使用 sudo（不推荐用于交叉编译）
sudo make install

# 或修改 Makefile 中的 PREFIX
make install PREFIX=/home/user/local

问题 3：编译错误

错误信息：

tree.c:1234:5: error: expected ';' before '}'

原因：源代码语法错误或编译器版本不兼容。

解决方案：

# 检查编译器版本
gcc --version

# 使用兼容的编译器选项
make CC=gcc CFLAGS="-g -O2 -Wall"

# 清理并重新编译
make clean
make

问题 4：颜色显示异常

错误信息：终端中颜色显示不正确。

原因：终端不支持颜色或颜色配置错误。

解决方案：

# 禁用颜色
tree -n

# 检查终端颜色支持
echo $TERM

# 设置终端类型
export TERM=xterm-256color

# 检查 LS_COLORS
echo $LS_COLORS

问题 5：符号链接问题

错误信息：符号链接显示异常或导致无限循环。

原因：符号链接处理不当。

解决方案：

# 不跟随符号链接
tree -l

# 限制递归深度
tree -L 3

# 排除符号链接
tree -I "*" --prune

问题 6：大目录性能问题

错误信息：处理大目录时速度很慢。

原因：目录包含大量文件。

解决方案：

# 限制显示深度
tree -L 2

# 限制文件数量
tree --filelimit 100

# 只显示目录
tree -d

# 使用过滤
tree -I "node_modules|target|*.o"

---

适配开源鸿蒙 PC 端的要点

系统环境差异

1. 包管理器

HarmonyOS PC 使用 HNP（HarmonyOS Native Package）作为包管理格式，而不是传统的 apt、yum 或 brew。

影响：

• 需要创建 HNP 包配置文件（hnp.json）
• 安装路径遵循 HNP 规范
• 包管理命令不同

2. 依赖库

tree 使用标准 C 库，HarmonyOS 使用 musl libc：

• 链接方式：可以使用静态链接或 musl 兼容的动态链接
• 系统调用：标准 C 库函数应该兼容
• 库依赖：tree 不依赖外部库，只需要标准 C 库

3. 文件系统

HarmonyOS 的文件系统结构可能与标准 Linux 不同：

• 路径格式：确保路径格式正确
• 权限：确保文件权限设置正确
• 符号链接：符号链接处理应该兼容

Makefile 构建系统适配

1. 编译器配置

需要配置 Makefile 使用 HarmonyOS SDK 的编译器：

make CC="${CC}" CFLAGS="${CFLAGS}" LDFLAGS="${LDFLAGS}"

关键变量：

• CC: C 编译器（HarmonyOS SDK 的 clang）
• CFLAGS: 编译标志（包含交叉编译选项）
• LDFLAGS: 链接标志

2. 安装路径配置

使用 DESTDIR 和 PREFIX 控制安装路径：

make install DESTDIR=${TREE_INSTALL_HNP_PATH} PREFIX=/usr

路径结构：

• 二进制文件：${DESTDIR}${PREFIX}/bin
• 手册页：${DESTDIR}${PREFIX}/man/man1

3. Makefile 变量

tree 的 Makefile 使用以下变量：

PREFIX?=/usr/local
DESTDIR=${PREFIX}/bin
MANDIR=${PREFIX}/man

需要确保这些变量正确设置。

关键适配要点总结

1. 编译器配置：使用 HarmonyOS SDK 的编译器
2. 安装路径：使用 DESTDIR 和 PREFIX 控制
3. 目录创建：提前创建安装目录
4. 包格式：遵循 HNP 规范

---

鸿蒙适配中的报错解决过程

报错 1：构建系统识别错误

错误信息：

make: *** No rule to make target `clean'. Stop.
make: *** No targets specified and no makefile found. Stop.

原因分析：
原始的构建脚本可能没有正确设置工作目录或 Makefile 不存在。

解决过程：

1. 检查 Makefile：

   ls -la Makefile
   # 确认 Makefile 存在
   

2. 检查构建脚本：

   • 确保在正确的目录下运行
   • 确保设置了正确的环境变量

3. 修改构建脚本：

   • 添加清理步骤的错误处理
   • 确保在构建前清理旧文件

最终解决方案：

# 清理之前的构建
make clean 2>/dev/null || true

# 构建
make CC="${CC}" CFLAGS="${CFLAGS}" LDFLAGS="${LDFLAGS}"

报错 2：安装路径权限错误

错误信息：

install: /usr/local/bin/tree: Permission denied
make: *** [install] Error 1

原因分析：
make install 尝试安装到系统目录 /usr/local/bin，需要 root 权限。在交叉编译时，不应该安装到系统目录。

排查思路：

1. 检查 Makefile 的 install 目标：

   grep -A 10 "^install:" Makefile
   # 发现使用了 DESTDIR 和 PREFIX
   

2. 检查环境变量：

   echo $DESTDIR
   echo $PREFIX
   # 发现未设置或设置不正确
   

3. 查看 Makefile 变量定义：

   PREFIX?=/usr/local
   DESTDIR=${PREFIX}/bin
   MANDIR=${PREFIX}/man
   

解决方案：

设置 DESTDIR 和 PREFIX 环境变量：

# 设置安装路径变量
export DESTDIR=${TREE_INSTALL_HNP_PATH}
export PREFIX=/usr

# 使用 DESTDIR 安装
make install

工作原理：

• DESTDIR 是安装的根目录
• PREFIX 是相对于 DESTDIR 的路径
• 最终安装路径 = ${DESTDIR}${PREFIX} = ${TREE_INSTALL_HNP_PATH}/usr
• Makefile 会创建 ${DESTDIR}${PREFIX}/bin、${DESTDIR}${PREFIX}/man/man1 等目录

报错 3：安装目录不存在

错误信息：

cp: directory /Users/jianguo/HarmonyOSPC/build/data/service/hnp//tree.org/tree_2.2.1 does not exist
Error: Failed to copy hnp.json

原因分析：
安装目录不存在，make install 可能失败或目录未创建。

解决方案：

# 创建安装目录
mkdir -p ${TREE_INSTALL_HNP_PATH}/usr/bin
mkdir -p ${TREE_INSTALL_HNP_PATH}/usr/man/man1

适配过程中的关键决策

1. 使用 DESTDIR 和 PREFIX：解决安装路径问题
2. 提前创建目录：确保安装目录存在
3. 错误处理完善：添加详细的错误检查和提示

---

构建脚本详解

build_ohos.sh 完整代码

export TREE_INSTALL_HNP_PATH=${HNP_PUBLIC_PATH}/tree.org/tree_2.2.1

sys_prefix=${PREFIX}
export PREFIX=${TREE_INSTALL_HNP_PATH}
echo "${PREFIX}"

# 创建安装目录
mkdir -p ${TREE_INSTALL_HNP_PATH}/usr/bin
mkdir -p ${TREE_INSTALL_HNP_PATH}/usr/man/man1

# 清理之前的构建
make clean 2>/dev/null || true

# 构建
echo "Building tree..."
make CC="${CC}" CFLAGS="${CFLAGS}" LDFLAGS="${LDFLAGS}" VERBOSE=1 || {
    echo "Error: Build failed"
    exit 1
}

# 安装
echo "Installing tree..."
# 设置安装路径变量
export DESTDIR=${TREE_INSTALL_HNP_PATH}
export PREFIX=/usr
# 使用 DESTDIR 安装，这样会安装到 ${DESTDIR}${PREFIX} = ${TREE_INSTALL_HNP_PATH}/usr
make install || {
    echo "Error: Install failed"
    exit 1
}

# 复制 hnp.json
cp hnp.json ${TREE_INSTALL_HNP_PATH}/ || {
    echo "Error: Failed to copy hnp.json"
    exit 1
}

# 打包
echo "Packaging..."
pushd ${TREE_INSTALL_HNP_PATH}/../
    ${HNP_TOOL} pack -i ${TREE_INSTALL_HNP_PATH} -o ${ARCHIVE_PATH}/ || {
        echo "Error: HNP pack failed"
        popd
        exit 1
    }
    tar -zvcf ${ARCHIVE_PATH}/ohos_tree_2.2.1.tar.gz tree_2.2.1/ || {
        echo "Error: Tar packaging failed"
        popd
        exit 1
    }
popd

# 打印构建结果
echo ""
echo "=========================================="
echo "Build completed successfully!"
echo "=========================================="
echo "HNP Package: ${ARCHIVE_PATH}/tree.org_tree_2.2.1.hnp"
echo "Tar Archive: ${ARCHIVE_PATH}/ohos_tree_2.2.1.tar.gz"
echo "Installation Path: ${TREE_INSTALL_HNP_PATH}"
echo "=========================================="
echo ""

export PREFIX=${sys_prefix}

脚本关键点解析

1. 安装目录创建

作用：确保安装目录存在，避免安装失败。

实现：

mkdir -p ${TREE_INSTALL_HNP_PATH}/usr/bin
mkdir -p ${TREE_INSTALL_HNP_PATH}/usr/man/man1

2. 编译器配置

作用：使用 HarmonyOS SDK 的编译器进行交叉编译。

实现：

make CC="${CC}" CFLAGS="${CFLAGS}" LDFLAGS="${LDFLAGS}"

3. 安装路径控制

作用：使用 DESTDIR 和 PREFIX 控制安装路径。

实现：

export DESTDIR=${TREE_INSTALL_HNP_PATH}
export PREFIX=/usr
make install

路径映射：

• DESTDIR = ${TREE_INSTALL_HNP_PATH}
• PREFIX = /usr
• 最终安装路径：${TREE_INSTALL_HNP_PATH}/usr/bin/tree

---

HNP 包配置

hnp.json

{
    "type": "hnp-config",
    "name": "tree",
    "version": "2.2.1",
    "install": {}
}

安装目录结构

tree_2.2.1/
├── usr/
│   ├── bin/
│   │   └── tree                    # 主程序
│   └── man/
│       └── man1/
│           └── tree.1              # 手册页
└── hnp.json                         # HNP 包配置

---

构建结果

构建成功后，会生成以下文件：

1. HNP 包：tree.org_tree_2.2.1.hnp

   • HarmonyOS 原生包格式
   • 可以直接安装到 HarmonyOS 设备

2. Tar 归档：ohos_tree_2.2.1.tar.gz

   • 压缩的 tar 归档
   • 包含完整的安装目录结构

构建输出示例

==========================================
Build completed successfully!
==========================================
HNP Package: /path/to/archive/tree.org_tree_2.2.1.hnp
Tar Archive: /path/to/archive/ohos_tree_2.2.1.tar.gz
Installation Path: /path/to/data/service/hnp/tree.org/tree_2.2.1
==========================================

---

仓库地址与安装方式

仓库地址

HarmonyOS 适配版本：

• 仓库：https://gitcode.com/OpenHarmonyPCDeveloper/cmdtree
• 原始项目：https://github.com/Old-Man-Programmer/tree

安装方式

Linux（通用）

使用包管理器：

# Ubuntu/Debian
sudo apt install tree

# Fedora
sudo dnf install tree

# Arch Linux
sudo pacman -S tree

# Alpine Linux
apk add tree

从源码编译：

# 1. 下载源码
git clone https://github.com/Old-Man-Programmer/tree.git
cd tree

# 2. 编辑 Makefile（可选）
# 设置 PREFIX 和 MANDIR

# 3. 编译
make

# 4. 安装
sudo make install

macOS

使用 Homebrew：

brew install tree

使用 MacPorts：

sudo port install tree

从源码编译：

# 与 Linux 相同
make
sudo make install

Windows

使用 Chocolatey：

choco install tree

使用 Scoop：

scoop install tree

从源码编译：

# 需要 MinGW 或 Visual Studio
# 参考 Makefile 中的 Windows 配置

开源鸿蒙 PC

使用 HNP 包：

# 安装 HNP 包
hnp install tree.org_tree_2.2.1.hnp

# 或使用 tar 归档
tar -xzf ohos_tree_2.2.1.tar.gz
# 手动复制到系统路径

从源码交叉编译：

# 1. 克隆仓库
git clone https://gitcode.com/OpenHarmonyPCDeveloper/cmdtree.git
cd cmdtree

# 2. 设置 HarmonyOS SDK 路径
export OHOS_SDK=/path/to/ohosdk

# 3. 运行构建脚本
./build_ohos.sh

# 4. 安装生成的 HNP 包
hnp install tree.org_tree_2.2.1.hnp

验证安装

# 检查版本
tree --version

# 测试基本功能
tree -L 1

# 查看帮助
tree --help

---

总结

适配要点

1. 构建系统：使用 Makefile，需要正确配置编译器
2. 安装路径：使用 DESTDIR 和 PREFIX 控制
3. 目录创建：提前创建安装目录
4. 包格式：遵循 HNP 规范

关键决策

1. DESTDIR 和 PREFIX：解决安装路径问题
2. 提前创建目录：避免安装失败
3. 错误处理完善：添加详细的错误检查和提示

优势

• 零运行时依赖：单一可执行文件，部署简单
• 高性能：C 语言编写，运行速度快
• 功能强大：支持多种输出格式和过滤选项
• 易于集成：可以轻松集成到脚本和工具链中

适用场景

• 项目结构展示
• 文档生成
• 系统管理
• 代码审查
• 磁盘空间分析

---

FAQ

Q1: tree 和 ls -R 有什么区别？

A: 主要区别：

• 格式：tree 使用树状格式，ls -R 使用列表格式
• 可视化：tree 更直观，层次关系清晰
• 功能：tree 支持更多选项（HTML、JSON、过滤等）
• 性能：tree 在处理大目录时可能更快

Q2: 如何只显示目录？

A:

# 使用 -d 选项
tree -d

# 限制深度
tree -d -L 2

Q3: 如何排除某些文件或目录？

A:

# 使用 -I 选项排除模式
tree -I "node_modules|target|*.o"

# 使用 --gitignore 选项
tree --gitignore

# 组合使用
tree -I "node_modules|target" --gitignore

Q4: 如何在 HarmonyOS 上使用 tree？

A:

1. 安装 HNP 包：hnp install tree.org_tree_2.2.1.hnp
2. 或从源码交叉编译
3. 使用方式与 Linux 相同

Q5: 如何生成 HTML 格式的目录树？

A:

# 生成 HTML 文件
tree -H . -o directory_tree.html

# 指定标题
tree -H . --title "Project Structure" -o output.html

Q6: 如何显示文件大小？

A:

# 显示文件大小（字节）
tree -s

# 显示人类可读的大小
tree -s -h

# 显示所有信息
tree -s -h -p -D

Q7: 如何按时间排序？

A:

# 按修改时间排序
tree -t

# 反向排序
tree -t -r

# 按大小排序
tree -S

Q8: 如何限制显示深度？

A:

# 限制深度为 2 层
tree -L 2

# 限制深度为 1 层
tree -L 1

# 结合其他选项
tree -L 2 -d -s

---

相关链接

• tree 官方网站：http://oldmanprogrammer.net/source.php?dir=projects/tree
• tree GitHub：https://github.com/Old-Man-Programmer/tree
• HarmonyOS 适配仓库：https://gitcode.com/OpenHarmonyPCDeveloper/cmdtree
• HarmonyOS 开发者文档：https://developer.harmonyos.com/
• PC代码仓
• PC社区