在码云上创建git仓库并与pycharm关联

1. 创建仓库：

到https://gitee.com （码云）注册一个账号,然后 创建一个git 仓库, 这个仓库可以设置为私有或者public.

2. 获取仓库地址：

打开新建的仓库，切换到 "</>代码”标签，在右侧有一个 “克隆/下载"选项，点击在下拉选项中选择https，复制对应的URL. 这就是仓库的https的访问地址.

3. 开发工具pycharm的配置：

因为要使用远程仓库，这时候有两种办法，一种是是把远程新的空仓库clone下来，然后再在这个clone 的仓库目录中进行开发，clone下来的新仓库就是一个project, 只是这个projects 是一个只有git 相关文档组成的projects, 而如果这个project并不是空的，那么clone下来当然有项目中的相关code等. 另一种是 把本地的代码直接push到远程的仓库. 无论哪一种，都需要首先安装gitee插件以及安装git这个工具. A. 首先要安装一个plugin, 名字叫做 gitee, 安装这个plugin 之后，才能配置pycharm连接到gitee. B. 安装之后，通过如下的界面，确保git 也是安装并且是ok的，如果没有安装，那么可以直接用pycharm来装;

image.png

C. 在上图中，选择Gitee, 然后指定gitee 登陆的用户名和密码，完成后，就成功关联了gitee 账户和pycharm.

如果是clone gitee上的仓库到本地，然后进行开发，简要步骤如下:"

选择菜单： VCS --->Get from Verson Control... , 然后弹出窗口如下，选择gitee, 在右侧会列出当前登录的gitee对应的仓库列表，选择对应仓库，然后选择clone, 完成后，就成功把project clone到本地了，然后可以在这个project里面进行开发.

如果是把本地的代码push到gitee上的仓库，那么简要步骤如下:

选择菜单： VCS--->Import into Verson Control..., 然后在级联菜单中选择 Share Project on Gitee , 在弹出的窗口中指定 repo的名字，以及选择是否为 private repo ， 然后选择确定，进一步弹出的窗口让确认哪些file 需要上传到repo.在完成后，然后在pycharm的右下角会显示是否提交成功. 此时在gitee中就可以看到刚才创建的git仓库.

4. 新手最常遇到的提交失败的报错：

A.

on Gitee, but initial commit failed:
            *** Please tell me who you are.
            Run
            git config --global user.email "you@example.com"
            git config --global user.name "Your Name"

在pycharm的右下角会弹出一个窗口，大意是：project 在gitee上创建成功，但是初始化提交失败... 然后点击下面的error , 看到的错误提示含有如上的一部分，这是因为： git 并不知道当前的用户，所以不能确定是谁提交的(虽然pycharm已经配置了如何连接gitee, 但是git 不知道当前用户是谁，默认会查找当前的系统用户名以及对应的domain 生成一个 username@domain的用户，但是这个用户在gitee上是找不到的)，所以要进行如下的配置： 找到git 的安装路径(在pycharm里面可以看到安装路径的哦)，然后执行： git config --global user.email "you@example.com" git config --global user.name "Your Name" 再次commit就可以成功了。 B. 因为git commit 仅仅是把code 提交到本地的repo,要上传到gitee, 那么要用git push, 也就是在pycharm中也需要进行push才可以在gitee上看到代码. 在pycharm的右上角，有一个git的工具栏，里面有update project, commit, push的选项. 其中update project表示从gitee的仓库来更新本地的repo, 当本地的code 和gitee上的code发生冲突的时候，会提示如何进行 合并： 一种是merge, 这种情况下，可能会出现不同方向的branch. 另一种是rebase, 也就是合并后不会出现新的branch. 而commit 就表示提交到本地的repo, 而push 就是把本地commit状态的push到gitee 仓库去. C. 然而在使用git push的时候，可能面临下面的新的错误信息：

!   refs/heads/master:refs/heads/master [rejected] (fetch first)
hint: not have locally. This is usually caused by another repository pushing
Done
hint: to the same ref. You may want to first integrate the remote changes
hint: (e.g., 'git pull ...') before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.

这个错误的大致意思是： 一些在gitee仓库的文件,在local是不存在的，这个时候可以通过git pull命令把remote 的相关内容pull到本地进行合并，然后再次进行git push. 这里使用：

git remote -v              #列出remote ，根据remote 的名字，执行下面的命令；
git pull --rebase origin master:master     #把 origin 的master 分支合并到本地的master分支， origini就是remote 的名字，可以从上一条命令获取，第一个master 是origin的分支，第二个master是local的分支，如果是合并到本地的当前分支，那么“:master” 参数可以省略. --rebase 参数的目的是：合并后不产生很多的branch. 
git branch 可以列出当前的所有分支，而其中 前面有 * 标志的是当前分支;

D. 我们在前面为了可以正常使用git, 配置了global 的 user.email, user.name 参数，而gitee 支持email 不公开的隐私保护措施，如果gitee配置了email不公开，而 git的global 参数 user.email 又配置了真实的email, 那么就会弹出警告，这时候可以把gitee的email不公开禁掉，也可以根据gitee的提示，配置 git 的global 参数 user.emai 为 gitee 提供的一个邮箱地址. 这时候新的问题又出现了： 如果在Push到gitee之前，已经用前一个邮箱git commit 了代码，现在push的话，依然会有相应提示，这时候需要首先在gitee把不公开邮箱暂时disable, 待成功push了之后，在启用"不公开邮箱功能". 要查看之前的代码是否用的“不公开邮箱”提交的，那么用git log命令.

5. 小结：

通过上面的步骤，基本上就配置好了git 仓库和pycharm的关联. 主要描述了如下的使用情形： A. gitee上创建仓库，然后pull 到本地，在这个pull下来的project中进行开发 B. 本地project 已经进行中，然后push到gitee，创建仓库，然后继续进行开发 C. 对于email 不想公开的处理办法 D. 如果gitee上和本地的不一致时候的处理办法，主要有两种：merge 或者rebase, 如果没有很复杂的功能确实需要新的branch, 那么建议用 rebase来处理. E. 个人倾向于：一个project 对应一个repo.

本文原创，转载请注明出处

                                            ------工欲善其事必先利其器