最近不少朋友问我，国内有没有好用点的代码托管平台，GitHub 有时候访问不太稳定，团队协作起来挺折腾。我前阵子正好把项目迁到了 GitCode，用了一段时间，感觉对新手挺友好。这篇 GitCode新手入门教程 就把我踩过的坑和实际操作的步骤捋一遍，不管你是刚学编程的学生，还是想给团队找个国内托管方案，照着做基本能跑通。
先搞清楚 GitCode 到底是干啥的
简单说，GitCode 就是一个代码托管平台，跟 GitHub、Gitee 属于同类。你可以把写好的代码传上去，方便备份、版本管理，也能跟别人一起协作开发。它支持 Git 命令操作，也有网页端界面，不想敲命令的时候直接点鼠标也能完成大部分操作。
我刚开始以为这类平台都差不多，实际用下来发现 GitCode 对国内网络环境做了优化，克隆和推送速度确实快不少，这点对经常要拉取大仓库的人来说挺实在。另外它上面有不少开源项目可以直接参考，学习的时候翻一翻别人的代码结构，比自己闷头想强。
注册账号和创建第一个仓库
打开 GitCode 官网，点注册，邮箱或者手机号都行，流程跟一般网站没区别。注册完建议先把个人资料里的 SSH 密钥配好，后面用命令行推送代码会方便很多，不然每次都要输密码，烦得很。
创建仓库的入口在右上角，点“新建仓库”。这里有几个选项要注意：仓库名称别用中文，用英文加短横线就行；初始化仓库那个勾，新手建议勾上，它会自动帮你生成 README 文件，省得后面还要手动建。公开还是私有看你自己需求，学习用的项目选公开就行，反正也没什么敏感内容。
把本地代码传上去的两种办法
第一种是纯网页操作，适合完全不想碰命令行的朋友。在仓库页面点“上传文件”，把本地的代码文件拖进去，填个提交信息，点确认就完事了。简单是简单，但文件多了会有点卡，而且不方便做版本回退。
第二种就是标准的 Git 命令操作，也是我比较推荐的方式。先在本地装好 Git，然后在项目文件夹里右键打开命令行，依次执行这几步：git init 初始化仓库，git add . 把所有文件加进去，git commit -m "第一次提交" 提交到本地，接着关联远程仓库 git remote add origin 你的仓库地址，最后 git push -u origin master 推上去。第一次推送可能会让你确认密钥，跟着提示走就行。
这里有个坑我得提一下，有些教程让你用 main 分支，但 GitCode 新建仓库默认分支有时候是 master，你推的时候看清楚远程分支名，别推错了地方干着急。
分支管理和多人协作怎么弄
一个人写代码的时候分支好像没啥用，但一旦涉及到团队协作，分支就是保命的东西。我的习惯是主分支只放稳定版本，自己开发新功能就切一个 dev 分支出来。命令就是 git checkout -b dev，写完再合并回去。
在 GitCode 网页端可以发起合并请求，也就是常说的 Pull Request。你把自己的分支推上去之后，点“新建合并请求”，选好源分支和目标分支，写清楚改了啥，等负责人审核通过就能合进主分支。这个流程走一遍就懂了，比光看文档强。
几个新手容易踩的坑
第一个是仓库地址选错协议。GitCode 提供 HTTPS 和 SSH 两种地址，用 HTTPS 的话每次推送都要输账号密码，用 SSH 配好密钥就一劳永逸。我一开始图省事用 HTTPS，结果一天输八遍密码，后来果断换了 SSH。
第二个是 .gitignore 文件没配好。有些编译产生的临时文件、依赖包文件夹，你不想传上去就得在 .gitignore 里写清楚，不然一股脑全推上去，仓库体积蹭蹭涨，后面清理起来特别麻烦。
第三个就是提交信息写得太随意。什么“改了一下”“更新”，过两个月自己都看不懂改了啥。建议养成习惯，每次提交写清楚动了哪个模块、解决了什么问题，找历史记录的时候能省不少时间。
日常使用的一些小技巧
网页端有个代码搜索功能挺好用，在仓库页面按斜杠键就能调出来，找某个函数或者变量在哪定义的很快。另外 GitCode 的 issue 功能可以拿来记待办事项，自己给自己提问题，解决了就关掉，比拿小本本记靠谱。
如果你之前用惯了 GitHub，迁移过来也不复杂，仓库地址改一下就行，Git 命令都是通用的。我现在的做法是 GitHub 和 GitCode 两边都放一份，互为备份，哪边访问快就用哪边，挺省心。
总的来说，GitCode新手入门 这件事没有想象中那么难，把注册、建仓库、推代码这三步走通，后面就是熟能生巧。别怕出错，大不了删了仓库重来，反正学习成本低。希望这篇教程能帮你少走点弯路，早点把代码管起来。
喜欢 
高兴
鬼脸
呵呵
无聊
伤心
