演示以在 GitHub 上的 Vitest 库为例,地址:github.com/vitest-dev/… 。
最常见的 clone
废话少说,直接 git clone:
git clone https://github.com/vitest-dev/vitest.git
# or GitHub 登陆情况下
git clone git@github.com:vitest-dev/vitest.git
这会把 Vitest 默认主分支(main/master)和其 commit 纪录以及所有的远程分支拉取下来,缺点就是拉取完整的 commit,时间相对较长。
获取分支的代码
获取固定分支的代码 git clone -b branchname
:
git clone -b develop git@github.com:vitest-dev/vitest.git
相比直接克隆,拉取的内容更多了,毕竟多拉取了一个分支:
如果不想拉取默认的 master / main 分支,可以继续添加 --single-branch
,只拉取 -b 指定的分支:
git clone -b develop --single-branch git@github.com:vitest-dev/vitest.git
此时 git branch -av
,只有一个本地和相对应的远程分支:
获取最新的代码
为了项目需求我想看下源码,并不想去开发贡献,之前 commit 对我没用,这时我们的需求就是如何获取最新的代码,可以通过 --depth=1
完成:
git clone --depth=1 https://github.com/vitest-dev/vitest.git
degit
上面所有的 clone 方法包括 --depth=1
都有个缺点,就是会带一个 git 环境,如果我们是开始一个新项目,需求是指向获取模板代而已,这时我们就可以使用 degit 工具来去除 git。
degit 是个 npm package,需要全局安装才能友好使用:
npm install -g degit
最长用的语法是下面这个,拉取一个远程库到新项目中:
degit user/repo my-new-project
这时我们就应该这么拉取:
degit vitest-dev/vitest my_project_name
结果一运行报错了:
原因是 degit 默认拉取的分支是 master,GitHub 因为黑人运动把参考新建的默认主分支切到了 main,vitest 的主分支就是 main。
但不要担心,我们只需要通过 #branch_name
的方式来获取就行了:
degit vitest-dev/vitest#main my_project_name
cd 进入 my_project_name 文件夹查看,有没有 git 的环境:
➜ degit_demo cd my_project_name
➜ my_project_name ls -al
结果非常 Nice。
degit 除了不带 git,还有一个好处就是缓存,我先进入根目录下,然后生成文件树:
➜ ~ cd ~/.degit
➜ .degit tree
f1b247ff4c7dd612174ce9b7f9f958a07712f973.tar.gz
就是根据远程库最新的 commitf1b247ff4c7dd612174ce9b7f9f958a07712f973 生成的,这样只要 commit 不更新我们就不要再去拉取了,舍弃一点硬盘,换取了时间。
PS: 如果你用过 Svelte 框架,一定熟悉下面这个语法:
npx degit sveltejs/template my-svelte-project
事实上 degit 的开发者也是 Svelte 的开发者。