仿 Dress 的照片投稿仓库, 适配自建 Gitea 平台 git.xhmcl.com: - README / GUIDE (PR 教程) / CONTRIBUTING / Q&A / EXIF / PARTIAL_CLONE (中英双语) - A-Z + # 首字母目录结构 - .gitea: PR 模板、维护者名单、7 个纯 bash + API 的 Actions 工作流 (可选功能) Co-Authored-By: Claude Code <noreply@anthropic.com>
110 lines
3.8 KiB
Markdown
110 lines
3.8 KiB
Markdown
# 部分克隆指南
|
||
|
||
[English](en-US/PARTIAL_CLONE.md)
|
||
|
||
小南娘仓库包含大量图片。只使用 `--depth 1` 会省略旧提交,但仍会下载当前版本中的全部图片。若你只准备修改自己的目录,推荐同时使用部分克隆和稀疏检出:Git 先下载提交与目录结构,仅在检出所选目录时按需下载其中的文件。
|
||
|
||
> 需要 Git 2.25 或更高版本。可运行 `git --version` 查看版本。
|
||
> 本平台只开放 HTTP(S) 访问,请使用 `https://` 地址(下文均已给出)。
|
||
|
||
## 首次克隆
|
||
|
||
先在平台上 Fork 本仓库,再克隆你自己的 Fork。将命令中的用户名和目录替换为实际值:
|
||
|
||
```bash
|
||
git clone --filter=blob:none --sparse --depth 1 https://git.xhmcl.com/<你的用户名>/dress-pr.git
|
||
cd dress-pr
|
||
|
||
# 只检出自己的目录;即使远端尚无该目录,也可以先设置
|
||
git sparse-checkout set '<首字母>/<你的文件夹名>'
|
||
```
|
||
|
||
例如,要使用 `Y/Yueosa`:
|
||
|
||
```bash
|
||
git sparse-checkout set 'Y/Yueosa'
|
||
```
|
||
|
||
此时工作区会包含根目录文档和 `Y/Yueosa`,不会出现其他贡献者的图片。若文件夹名以数字或符号开头,请使用 `#` 目录,并务必给路径加引号:
|
||
|
||
```bash
|
||
git sparse-checkout set '#/233'
|
||
```
|
||
|
||
接下来可以创建目录、添加照片并正常使用 `git add`、`git commit` 和 `git push`。完整贡献流程请继续阅读[新手指南](GUIDE.md)。
|
||
|
||
## 管理检出目录
|
||
|
||
查看当前选择的目录:
|
||
|
||
```bash
|
||
git sparse-checkout list
|
||
```
|
||
|
||
追加另一个目录,同时保留已有目录:
|
||
|
||
```bash
|
||
git sparse-checkout add 'A/AnotherName'
|
||
```
|
||
|
||
重新选择目录时,`set` 会替换之前的目录列表:
|
||
|
||
```bash
|
||
git sparse-checkout set 'F/FirstName' 'S/SecondName'
|
||
```
|
||
|
||
Git 会在需要时自动下载新选目录中的文件,因此目录越小,下载量和磁盘占用通常越少。
|
||
|
||
## 获取更多历史
|
||
|
||
`--depth 1` 创建的是浅克隆,只包含最新一次提交。普通的添加照片和发起 PR 不受影响;若需要查看完整历史,可运行:
|
||
|
||
```bash
|
||
git fetch --unshallow
|
||
```
|
||
|
||
这会获取完整提交历史,但图片内容仍由部分克隆按需下载。
|
||
|
||
## 恢复完整仓库
|
||
|
||
如果只想让当前版本的所有文件出现在工作区,可关闭稀疏检出:
|
||
|
||
```bash
|
||
git sparse-checkout disable
|
||
```
|
||
|
||
该命令会下载当前版本中尚未获取的文件,数据量可能很大。仓库仍然保留部分克隆设置,旧版本文件会继续按需下载。
|
||
|
||
如果确实需要把仓库转换为包含全部历史和文件内容的完整克隆,可继续运行:
|
||
|
||
```bash
|
||
git fetch --unshallow --no-filter
|
||
git config --unset remote.origin.partialclonefilter
|
||
git config --unset remote.origin.promisor
|
||
```
|
||
|
||
若之前已经执行过 `git fetch --unshallow`,再次执行时会提示仓库并非浅克隆;此时改用 `git fetch --no-filter` 即可。
|
||
|
||
## 常见问题
|
||
|
||
### 为什么根目录文档仍会出现?
|
||
|
||
`git clone --sparse` 默认使用锥形模式。该模式会保留仓库根目录的文件,便于直接阅读 `README.md`、`GUIDE.md` 等说明文档。
|
||
|
||
### 为什么看不到刚选择的目录?
|
||
|
||
先运行 `git sparse-checkout list` 核对路径、大小写和首字母目录。远端不存在的新目录不会自动显示,创建并加入文件后才会出现在工作区中。
|
||
|
||
### 部分克隆会影响提交或 PR 吗?
|
||
|
||
不会。未检出的文件仍由 Git 管理,不会因为 `git add` 或提交自己的目录而被删除。请只修改自己的目录,并在提交前使用 `git status` 核对变更。
|
||
|
||
### 推送时提示认证失败?
|
||
|
||
本平台没有 SSH,推送需使用 `https://` 地址并以「用户名 + 访问令牌」认证。令牌生成方法见[新手指南](GUIDE.md) 第二步方法 B。
|
||
|
||
## 参考
|
||
|
||
- [Git 官方文档:部分克隆](https://git-scm.com/docs/partial-clone)
|
||
- [Git 官方文档:稀疏检出](https://git-scm.com/docs/git-sparse-checkout)
|