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来装;
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.
本文原创,转载请注明出处
------工欲善其事必先利其器