第一步
菜鸟教程-Git教程
点击上方链接,完成Git的安装,并了解Git 工作流程,知道Git 工作区、暂存区和版本库的区别
第二步
GitCode官方帮助文档-SSH 公钥管理
点击上方链接,完成SSH公钥设置
第三步(GitCode的官方引导命令解释,可结合第一步的Git教程理解)
Git 全局设置(按序执行)
git config --global user.name "bfydyjs"
- 作用:使用 git config 命令来配置 Git 的相关设置,–global 选项表示这是一个全局配置,意味着在你系统上的所有 Git 仓库都会使用这个配置。user.name 是设置提交代码时显示的用户名,这里将用户名设置为 “bfydyjs”。
- 影响:之后你在任何 Git 仓库进行提交操作时,提交记录中显示的作者姓名就会是 “bfydyjs”。
git config --global user.email "bfydyjs@noreply.gitcode.com"
- 作用:同样使用 git config --global 进行全局配置,user.email 用于设置提交代码时显示的邮箱地址,这里将邮箱设置为 “bfydyjs@noreply.gitcode.com”。
- 影响:在后续的提交记录中,除了作者姓名,还会显示这个邮箱地址。在一些代码托管平台(如 GitHub、GitCode 等),邮箱地址会关联到你的账户,方便平台识别提交者的身份。
创建一个新仓库(按序执行)
git clone https://gitcode.com/bfydyjs/opengait.git
- 作用:从 gitcode.com 上克隆 bfydyjs 用户的 opengait 仓库到本地。克隆完成后,会在当前目录下创建一个名为 opengait 的文件夹,其中包含远程仓库的所有文件和版本历史。
- 可能出现的问题:
网络问题:如果网络连接不稳定或者无法访问 gitcode.com,克隆操作会失败。
权限问题:若你没有权限访问该仓库,会收到认证失败的提示。
cd opengait
- 作用:进入克隆下来的 opengait 项目文件夹,以便后续对项目文件进行操作。
- 可能出现的问题:若克隆过程中出现问题,没有成功创建 opengait 文件夹,执行该命令会提示 “没有那个文件或目录”。
echo "# opengait" >> README.md
- 作用:向 README.md 文件末尾追加一行内容 # opengait。README.md 文件通常用于对项目进行简要说明。
- 可能出现的问题:若 README.md 文件不存在,会先创建该文件再追加内容;若没有写入权限,会提示权限不足。
git add README.md
- 作用:将 README.md 文件添加到 Git 的暂存区,意味着该文件的更改已被标记,准备提交到本地仓库。
- 可能出现的问题:若 README.md 文件不在当前 Git 仓库管理范围内,或者文件名拼写错误,会提示找不到该文件。
git commit -m "add README"
- 作用:将暂存区中的 README.md 文件更改提交到本地仓库,并添加一条提交说明 “add README”,方便后续查看和理解该提交的内容。
- 可能出现的问题:若没有正确配置 Git 的用户名和邮箱,会提示需要先配置这些信息才能提交。
git branch -m main
- 作用:将当前所在的分支重命名为 main。在较新的 Git 版本中,默认的主分支名称通常为 main。
- 可能出现的问题:若当前分支已经是 main 分支,再次执行该命令不会有实际效果。
git push -u origin main
- 作用:将本地 main 分支上的更改推送到远程仓库的 main 分支。-u 选项用于设置上游分支,这样后续使用 git push 或 git pull 时,就无需再指定远程仓库和分支名称。
- 可能出现的问题:
权限问题:若你没有权限向远程仓库推送更改,会收到认证失败的提示。
冲突问题:若远程仓库的 main 分支有新的更改,而本地分支没有合并这些更改,会出现冲突,需要先解决冲突才能推送。
推送现有的文件(按序执行)
cd existing_folder
- 作用:切换到已存在的本地文件夹 existing_folder 中。这里的 existing_folder 是你本地存放项目文件的目录,你需要将其替换为实际的文件夹名称。
- 示例:如果你的项目文件存放在 my_project 文件夹中,命令则为 cd my_project。
git init
- 作用:在当前目录下初始化一个新的 Git 仓库。执行该命令后,Git 会在当前目录下创建一个隐藏的 .git 文件夹,用于存储版本控制所需的元数据和对象数据库。
git remote add origin https://gitcode.com/bfydyjs/opengait.git
- 作用:将本地仓库与远程仓库建立关联。origin 是远程仓库的默认别名,git@gitcode.com:bfydyjs/opengait.git 是远程仓库的 SSH 地址。
- 注意:你需要确保已经在 gitcode.com 上创建了对应的仓库,并且本地的 SSH 密钥已经添加到 gitcode.com 的账户中,否则在后续推送时会出现认证失败的问题。
git add .
- 作用:将当前目录下的所有文件和文件夹添加到 Git 的暂存区。暂存区是 Git 中一个中间区域,用于准备提交的文件。
- 注意:. 表示当前目录下的所有文件和文件夹,如果你只想添加特定的文件或文件夹,可以将 . 替换为具体的文件或文件夹名称。
git commit -m "Initial commit"
- 作用:将暂存区中的文件提交到本地仓库。-m 选项用于指定提交的说明信息,这里的 “Initial commit” 表示这是第一次提交。提交说明应该简洁明了,能够描述本次提交的主要内容。
git branch -m main
- 作用:将当前分支的名称修改为 main。在较新的 Git 版本中,默认的主分支名称通常为 main,而不是之前的 master。
git push -u origin main
- 作用:将本地仓库中的 main 分支推送到远程仓库的 main 分支。-u 选项的作用是设置上游分支,这样以后使用 git push 或 git pull 时就无需再指定远程分支和本地分支。
推送现有的 Git 仓库(按序执行)
cd existing_repo
- 作用:切换到已存在的本地仓库目录 existing_repo。你需要将 existing_repo 替换为实际的本地仓库文件夹名称。
- 示例:若本地仓库文件夹名为 my_project,则使用 cd my_project。
git remote rename origin old-origin
- 作用:将当前本地仓库关联的名为 origin 的远程仓库重命名为 old - origin。这样做是为了后续添加新的远程仓库地址,避免名称冲突。
- 可能出现的问题:若本地仓库没有名为 origin 的远程仓库,会出现错误提示。可使用 git remote 命令查看当前本地仓库关联的远程仓库名称。
git remote add origin https://gitcode.com/bfydyjs/opengait.git
- 作用:为本地仓库添加一个新的名为 origin 的远程仓库,其地址为 https://gitcode.com/bfydyjs/opengait.git。
- 可能出现的问题:如果新的远程仓库地址无效,或者你没有访问该仓库的权限,后续操作会失败。同时,若已经存在名为 origin 的远程仓库(尽管之前重命名过,但可能其他操作又添加了),会出现错误提示。
git push -u origin --all
- 作用:将本地仓库中的所有分支推送到新的 origin 远程仓库,并使用 -u 选项将这些分支与远程仓库的对应分支进行关联。这样后续使用 git push 和 git pull 时,就无需再指定远程仓库和分支名称。
- 可能出现的问题:如果本地分支和远程分支存在冲突,需要先解决冲突才能推送。另外,如果没有访问新远程仓库的权限,推送会失败。
git push -u origin --tags
- 作用:将本地仓库中的所有标签推送到新的 origin 远程仓库,并建立关联。标签通常用于标记特定的版本。
- 可能出现的问题:同样,若没有权限访问远程仓库或者标签存在冲突,推送会失败。
最后
- 自己多尝试,熟能生巧