最轻量确认文件是否存在用 git ls-tree，查内容用 git grep，预览用 git show；三者均无需 checkout，速度快、无副作用，且支持远程分支和精确路径匹配。
git ls-tree 查看分支中是否存在某文件
想确认某个文件在特定分支里有没有，最轻量的方式不是 checkout，而是用 git ls-tree 直接查索引。它不依赖工作区，速度快、无副作用。
-
git ls-tree -r origin/main -- src/utils/format.js：加-r递归查找，路径支持通配但需引号包裹（如"src/utils/*.js"） - 返回为空说明文件不存在；有输出则显示 mode、type、hash 和路径，比如
100644 blob a1b2c3... src/utils/format.js - 注意：路径必须是相对于仓库根目录的，不能写成
./src/...或绝对路径 - 如果分支名含斜杠（如
feature/login），直接写全名，无需引号——除非 shell 报错，才用单引号包住
git grep 在指定分支中搜文件内容
光知道文件存在还不够，常要确认里面有没有某段代码或配置。用 git grep 可以跳过 checkout，直接在分支的 HEAD 中搜索内容。
-
git grep -n "API_TIMEOUT" origin/develop -- package.json：-n显示行号，--后跟路径限制范围，避免扫全 repo - 若提示
fatal: Not a git repository，说明当前不在 git 仓库内；若提示fatal: bad revision 'origin/develop'，先git fetch更新远程引用 - 正则支持有限，复杂匹配建议加
-E（如git grep -E "(timeout|retry)"），但别用 PCRE 特性（-P在部分 Git 版本不可用） - 默认区分大小写，需要忽略大小写时加
-i，但会略微变慢
git show 快速预览分支中某文件内容
确认文件存在且内容关键，又不想切分支打开编辑器？git show 是最直接的“cat”替代方案。
-
git show main:src/api/client.ts：冒号前是 commit/ref（可为分支名、tag 或 hash），冒号后是仓库内路径 - 如果文件是二进制（如图片），会输出
Binary file ... matches，此时无法查看内容——这不是错误，是 Git 的正常行为 - 想保存到本地临时查看：
git show feature/docs:README.md > /tmp/README.md，注意路径必须准确，否则报pathspec '...' did not match any file(s) - 别用
git show HEAD:...代替分支名，因为HEAD指向当前所在分支，不是目标分支
为什么不用 git checkout + find？
有人习惯先 git checkout branch-name 再用 find 或编辑器搜索，这在多数场景下是低效且危险的。
- 切换分支可能触发大量文件重写，尤其当工作区有未提交变更时，Git 会拒绝切换或自动 stash，引入不确定性
-
find . -name "*.config.js"会扫描整个工作区，包括node_modules和.git，速度慢且结果混杂 - 如果目标分支已删除或远程尚未同步，
git checkout会失败，而git ls-tree和git show对远程分支（如origin/xxx）天然支持 - CI/CD 脚本中应完全避免
checkout来查文件，既慢又容易污染环境
真正卡住的点往往不是命令记不住，而是路径写错、分支没 fetch、或者把工作区路径当成仓库路径来用——这几个地方多 check 一遍，比背命令有用得多。
