要查看Git上传到服务器的文件格式，最直接的方法是用git ls-tree -r HEAD --name-only命令递归列出所有文件，再对后缀名进行归类统计。
很多人只知道用git push把代码推上去，却很少关心远程仓库里到底存了哪些类型的文件，无论你是做代码审查、清理非必要文件，还是想确认项目结构是否规范，掌握文件格式的查看方法都能帮你省下不少时间，下面我会从最常用的命令开始，逐步拆解不同场景下的操作技巧。
git查看远程仓库文件后缀的两种实用方法
基础命令递归列出所有文件
git ls-tree是Git提供的一个底层命令，专门用来查看树对象的内容，加上-r参数会递归遍历所有子目录，HEAD代表当前分支的最新提交，--name-only只输出文件名，不附带权限和哈希值。
git ls-tree -r HEAD --name-only
执行后你会看到类似这样的输出：
src/index.js
src/utils/helper.ts
docs/README.md
assets/logo.png这些文件名本身就包含了后缀,也就是文件格式，如果你想只看某一种格式，比如只列出所有JavaScript文件，可以用grep过滤：
git ls-tree -r HEAD --name-only | grep '.js$'
提取后缀并统计文件格式分布
如果仓库文件很多,手动浏览后缀明显不现实，这时候可以把管道命令串起来，快速统计每种格式的文件数量。
git ls-tree -r HEAD --name-only | awk -F. 'NF>1{print $NF}' | sort | uniq -c | sort -rn
这条命令的作用是：提取所有文件名中最后一个点之后的部分（即后缀），然后排序、去重、计数，最后按数量从高到低排列，输出结果类似：
42 js
18 ts
12 json
8 md
5 png
2 yaml这样你就能一眼看清仓库里哪种文件格式占大头,对于git仓库文件类型统计这个需求，这个方法是最高效的。
git ls-tree与git ls-files的差异
很多人会问,为什么不用git ls-files？git ls-files列出的是当前工作目录中Git已经跟踪的所有文件，但它的输出依赖你本地仓库的状态，如果你刚拉取了一个远程分支，还没有执行
git checkout，git ls-files可能不会显示所有文件，而git ls-tree直接读取Git对象数据库中的树对象，反映的是某个提交（比如HEAD）的准确快照，相当于“远程服务器上已经存储的内容”。git服务器文件格式查询更推荐使用git ls-tree，除非你明确需要查看本地跟踪状态。
通过git log查看文件变更历史中的格式
查看最近提交引入了哪些新文件
有时候你关心的不是当前仓库里有哪些文件格式,而是git查看上传给服务器有哪些文件格式在最近一次推送中发生了哪些变化，这时候可以用git log加上--name-only参数。
git log -1 --name-only --pretty=format:""
这会显示最后一次提交中新增、修改或删除的文件列表，如果只想看新增的文件，可以结合git diff使用：
git diff HEAD~1 HEAD --name-only --diff-filter=A
--diff-filter=A只显示新增文件（Added），你可以把A换成M（修改）、D（删除）等，这个技巧在代码审查时非常实用，能快速定位新引入的文件格式是否存在问题。
对比两个分支之间的文件格式差异
假设你有一个develop分支和一个main分支，想看看develop比main多了哪些文件格式，可以这样操作：
git diff main develop --name-only --diff-filter=A | awk -F. 'NF>1{print $NF}' | sort -u
这条命令会列出所有在develop分支中新增且不在main分支中的文件后缀，这在准备合并请求前做git上传文件格式检查时很有用，能避免不小心把.exe或.dll等二进制文件推送到代码仓库。
实际场景：git上传前检查文件格式
用pre-commit钩子拦截违规格式
很多团队会规定不允许上传某些文件格式,比如.log、.tmp、.zip等，与其靠人工审查，不如在Git的pre-commit
钩子里写一段脚本，自动检查即将提交的文件，发现违规格式就直接拒绝提交。
钩子文件位于.git/hooks/pre-commit，默认不存在，需要自己创建，脚本内容可以参考：
#!/bin/sh
for file in $(git diff --cached --name-only); do
case "$file" in
.log|.tmp|.zip|.exe)
echo "禁止提交 $file，请移除该文件后重试。"
exit 1
;;
esac
done
这样每次执行git commit时都会自动扫描缓存区中的文件后缀，如果包含.log等格式，提交会被阻断，这个机制对git上传文件格式检查等于加了一道自动门禁。
使用git filter-branch清理历史中的违规格式
如果仓库历史里已经混入了大量不该存在的文件格式（比如.DS_Store、Thumbs.db），可以用git filter-branch重写历史，彻底删除它们，不过这个操作会改变提交哈希，所以只适用于尚未推送到服务器或者整个团队都愿意重置历史的情况。
git filter-branch --force --index-filter 'git rm --cached --ignore-unmatch .DS_Store .Thumbs.db' --prune-empty --tag-name-filter cat -- --all
执行后,这些文件格式会从所有历史提交中消失，服务器上的相关记录也会被抹除，注意操作前要备份仓库，并提前通知所有协作者。
不同查看方法的实用对比
| 方法 | 适用场景 | 输出速度 | 是否依赖远程 |
|---|---|---|---|
git ls-tree -r HEAD --name-only |
查看特定提交的完整文件列表 | 快 | 不需要，使用本地对象库 |
git ls-files |
查看当前工作目录跟踪的文件 | 快 | 不需要，但依赖本地检出状态 |
git log --name-only |
查看某次提交变更的文件 | 中等 | 不需要，但可指定远程分支 |
git diff --name-only |
对比两个提交或分支的文件差异 | 中等 | 不需要 |
| 远程仓库Web界面（如GitHub） | 可视化浏览文件树，下载仓库 | 较慢，取决于网络 | 需要 |
从上表可以看出,最通用的方法还是git ls-tree，它不依赖本地工作目录是否干净，也不依赖网络，只要仓库完整克隆下来，就能快速得到准确的git查看上传文件类型命令结果。
常见问题：git查看文件格式相关
如何查看远程仓库里有哪些图片文件？
使用git ls-tree结合grep，用正则匹配常见的图片格式后缀：
git ls-tree -r HEAD --name-only | grep -E '.(png|jpg|jpeg|gif|svg|webp)$'
如果你只想统计数量,不关心具体文件名，可以再管道到wc -l：
git ls-tree -r HEAD --name-only | grep -cE '.(png|jpg|jpeg|gif|svg|webp)$'
统计git仓库中各文件格式数量时，排序命令的原理是什么？
核心命令是awk -F. 'NF>1{print $NF}'。-F.表示以点号作为分隔符，NF>1确保行里至少有一个点号（避免没有后缀的文件被误提取），$NF表示最后一个字段，也就是后缀名，后续的sort | uniq -c | sort -rn完成排序和计数，这个组合在git仓库文件类型统计场景下几乎成了标准做法，简洁且不需要额外安装工具。
为什么git ls-tree显示的文件格式比本地文件系统少？
因为git ls-tree只列出已经被Git跟踪的文件，而本地文件系统里可能还有.gitignore中忽略的临时文件、编译产物或IDE配置，如果你没有git add某些文件，它们也不会出现在HEAD的树对象中。git查看上传给服务器有哪些文件格式时，应该以git ls-tree的输出为准，它反映的是服务器上实际存储的内容，而不是你本地目录的完整清单。
掌握这些命令,无论是想快速了解一个陌生项目的组成，还是想在上传前把关文件格式，你都能做到心中有数，Git的底层工具虽然看似简单，但组合起来就能解决很多实际问题，下次面对一个仓库，不妨先跑一遍git ls-tree，看看它到底装着哪些“货色”。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/article/516158.html
