pipfile 不支持直接通过 `path` 字段指定本地仓库的分支；必须改用 `git` + `file://` 协议配合 `ref` 参数，才能让 pipenv 克隆并检出目标分支。
在 Pipenv 的依赖管理中，path 字段仅表示本地文件系统路径（如 ./src/mylib 或绝对路径），它被解释为已检出的源码目录，Pipenv 不会执行任何 Git 操作，因此 branch、ref、subdirectory 等 Git 相关字段在 path 下会被忽略——这也是你遇到锁文件生成失败的根本原因。
✅ 正确做法是：将本地仓库视为一个 Git 仓库，使用 git URL（含 file:// 协议）并显式指定 ref（可为分支名、标签或 commit hash）：
# Pipfile 中的正确写法
[packages]
repository2 = {editable = true, extras = ["dev"], git = "file:///Users/name.surname/Projects/repository2", ref = "feature/my_branch"}⚠️ 注意事项：
- file:// URL 必须是绝对路径，且需以三个斜杠开头（file:///...），这是 RFC 3986 规范要求；
- 路径中的空格和特殊字符需进行 URL 编码（例如空格 → %20），推荐避免使用；
- ref 支持分支名（如 "main"）、标签（如 "v1.2.0"）或完整 commit hash（如 "a1b2c3d"），但不支持简写 hash；
- 使用 editable = true 可确保以开发模式安装（即 pip install -e），便于同步本地修改；
- 若项目含子模块或需特定子目录，可补充 subdirectory = "subpkg" 字段（需 Pipenv ≥ 2023.10.5）。
? 命令行等效操作（可用于验证或临时安装）：
pipenv install -e "git+file:///Users/name.surname/Projects/repository2@feature/my_branch#egg=repository2[dev]"
? 提示：修改 Pipfile 后，务必运行 pipenv lock 重新生成 Pipfile.lock，确保依赖解析准确；若提示 Git error，请检查路径是否存在、Git 仓库是否初始化，以及分支名是否拼写正确。
总结：本地路径 ≠ Git 仓库引用。当需要绑定特定分支时，始终使用 git = "file://..." + ref = "..." 组合，这是 Pipenv 唯一支持的、可复现的分支级依赖声明方式。
