项目根目录到底在哪？Git、编辑器与 Monorepo 的 root 识别指南

软件工程里的 project root、workspace root 或 composition root 是目录/架构边界，不是 Android Root。名叫 rooter 的编辑器插件通常在帮你切换工作目录，不会解锁 Bootloader。本篇创建一个不下载依赖、不执行项目脚本的迷你 monorepo，让你亲自标出四种“根”。

你会完成什么#

• 从嵌套目录找出 Git 工作树顶层。
• 区分操作系统 /、当前工作目录、仓库根和 package root。
• 用一个根 package.json 声明两个 npm workspaces，但不运行安装脚本。
• 在 VS Code 中把陌生目录保持为 Restricted Mode，并理解 multi-root workspace。
• 删除实验目录后确认 Git 配置和软件权限没有被改变。

先看结论#

心智模型#

文件系统根 /
└─ <lab-dir>                    ← Git repository root / npm workspace root
   ├─ package.json
   ├─ apps/web/package.json     ← package root A
   └─ packages/ui/package.json  ← package root B
编辑器既可打开 <lab-dir>，也可把 A、B 作为多个逻辑 workspace folder

工具清单#

项目全景：软件根节点与工程结构的 14 个项目，一个不漏#

这 14 个项目主要把 root 当成“项目根目录”，也混入了根证书客户端、PCIe Root Port 和 Android 特权工具。文章应围绕“先找到正确边界，再在边界内操作文件”展开。

1. 编辑器项目根发现 · 5#

比较 Neovim/LSP 根目录探测器的标记文件、当前目录切换和多项目行为，并用测试仓库验证不会跳到错误父目录。

本组共 5 项：5 个源项目、0 个 Fork，其中 2 项已归档。新手应先从“未归档的源项目”核对 README 和 Release，再用 Fork 追溯设备适配或历史差异；分组本身不等于推荐安装。

2. 路径、环境与构建根 · 4#

覆盖 Python 路径、Nix flake、目录树和元数据不足的项目根管理器，重点是规范化路径、符号链接和可复现工作目录。

本组共 4 项：4 个源项目、0 个 Fork，其中 0 项已归档。新手应先从“未归档的源项目”核对 README 和 Release，再用 Fork 追溯设备适配或历史差异；分组本身不等于推荐安装。

3. 限定根目录的安全文件操作 · 1#

用 securefs 说明“限定在任意根目录内”并不等于 chroot 或 root 权限，验收点是路径逃逸、符号链接与竞态。

本组共 1 项：1 个源项目、0 个 Fork，其中 0 项已归档。新手应先从“未归档的源项目”核对 README 和 Release，再用 Fork 追溯设备适配或历史差异；分组本身不等于推荐安装。

4. 硬件架构中的 Root Port · 1#

单列 PCIe Root Port 的 RTL、BFM、软件栈和背板语义，避免把总线拓扑中的 root 与文件系统或超级用户混淆。

本组共 1 项：1 个源项目、0 个 Fork，其中 0 项已归档。新手应先从“未归档的源项目”核对 README 和 Release，再用 Fork 追溯设备适配或历史差异；分组本身不等于推荐安装。

5. 证书与 Android 跨界项目 · 3#

对 ACME 证书客户端、rooted 网络勘测和游戏内存导出只做用途与风险说明，并指向更合适类别；高风险工具不提供运行教程。

本组共 3 项：3 个源项目、0 个 Fork，其中 0 项已归档。新手应先从“未归档的源项目”核对 README 和 Release，再用 Fork 追溯设备适配或历史差异；分组本身不等于推荐安装。

开始前#

需要 Git、一个文本编辑器，可选 npm 与 VS Code。创建只用于实验的空目录 <lab-dir>，先运行 pwd 和 ls -la 确认目标。不要在现有项目、家目录或系统 / 中练习。示例不会运行 npm install，因此不会触发 preinstall/postinstall，也不需要 sudo。

操作步骤#

1. 建立只含元数据的目录树#

在 <lab-dir> 运行 git init，再创建 apps/web 和 packages/ui 两个目录。用编辑器在根目录写 package.json：{"name":"root-lab","private":true,"workspaces":["apps/*","packages/*"]}；分别在两个子目录写只含 {"name":"@lab/web","private":true} 与 {"name":"@lab/ui","private":true} 的 package.json。运行 git status --short，应只看到三个未跟踪 manifest；不要提交也不要安装依赖。

2. 从不同位置询问“根在哪”#

进入 apps/web，运行 pwd，再运行 git rev-parse --show-toplevel。前者是当前工作目录，后者应是 <lab-dir>。向上检查最近的 package.json：当前包根是 apps/web；顶层 package.json 的 workspaces 又把它纳入更大的 npm workspace。若安装了 npm，可在顶层运行只读的 npm pkg get workspaces；不要运行任何 npm run。

3. 观察编辑器根并回滚#

用 VS Code 打开 <lab-dir> 时先保持 Restricted Mode，检查 Explorer 显示的顶层。再用 “Add Folder to Workspace” 加入 apps/web 与 packages/ui，观察编辑器可以有两个逻辑 folder root，而 Git 顶层仍没变。不要安装自动 rooter 插件。关闭窗口且不保存 .code-workspace 即可回退编辑器状态；确认无需要保留的文件后，用文件管理器删除整个、路径已核对的 <lab-dir>。

验证#

• 从 apps/web 运行 git rev-parse --show-toplevel 返回实验目录，而不是 /。
• apps/web/package.json 和 packages/ui/package.json 定义两个 package root。
• 顶层 manifest 的 workspaces 只声明关系，没有下载依赖或执行脚本。
• 编辑器增加 folder root 不会改变 .git 所在位置。
• 删除实验目录后，没有全局 Git/npm 配置、文件权限或 Android 状态变化。

排错#

完成清单#

• □我能区分 /、pwd、Git top-level 和 package root。
• □我创建了两个逻辑包，但没有安装依赖或执行脚本。
• □我观察了 multi-root editor 与单一 Git worktree 的区别。
• □我未用 sudo 修复路径或权限问题。
• □我关闭编辑器并安全删除了专用实验目录。

一手资料#

• Git rev-parse --show-toplevel
• VS Code multi-root workspaces
• VS Code Workspace Trust
• npm workspaces
• pnpm workspaces
• rootutils upstream repository