工作流程

---

安装设置 git

下载最新版本的git

http://git-scm.com/downloads

当你安装完成git的时候，你需要简单的配置一下，打开终端：

用户名

第一步，你需要告诉git你的名字，这个名字会出现在你的提交记录中。

git config --global user.name "你的名字"

Email

然后是你的Email，同样，这个Email也会出现在你的提交记录中，请尽量保持此Email和您的码云的注册Email一致。

git config --global user.email "你的Email"

Clone 和 Push

Clone 项目

git clone http://gitee.com/xxxxxx/xxxxxx.git

创建特性分支

git checkout -b $feature_name

写代码，提交变更

git commit -am "My feature is ready"

将你的提交推送到 码云

git push origin $feature_name

在提交页面你可以查看你的变更，例如：

http://gitee.com/oschina/git-osc/commit/f3dd1c5bae48fa4244e2595a39e750e5606dd9be

创建一个 pull request

你可以fork任意的公开项目，当你修改了你fork的项目，你可以向源项目提交pull request。项目的作者在审阅过代码后可以决定是否将此变更应用到源项目。

在码云上使用SVN

使用教程已经整理在这里

---

SSH Keys

---

SSH key 可以让你在你的电脑和 Git @ OSC 之间建立安全的加密连接。

你可以按如下命令来生成sshkey

ssh-keygen -t rsa -C "xxxxx@xxxxx.com"# Creates a new ssh key using the provided email # Generating public/private rsa key pair...

查看你的public key，并把他添加到 Git @ OSC http://gitee.com/keys

cat ~/.ssh/id_rsa.pub # ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC6eNtGpNGwstc....

添加后，在终端（Terminal）中输入

ssh -T git@gitee.com

若返回

Welcome to 码云, yourname!

则证明添加成功。

---

关于权限

---

访客

对于公有项目：

创建issue评论Clone 和 Pull 项目打包下载代码Fork 项目创建 pull request

报告者

继承访客的权限私有项目：不能查看代码私有项目：不能下载代码私有项目：不能fork代码

观察者

继承报告者权限创建wiki打包下载代码不能push代码私有项目：可以fork

开发者

创建 issue评论Clone 和 Pull 项目打包下载代码创建 pull request创建分支推送分支删除分支创建标签（里程碑）创建 wiki

管理员

创建 issue评论Clone 和 Pull 项目打包下载代码创建 pull request创建分支推送分支删除分支创建标签（里程碑）创建 wiki添加项目成员强制推送分支编辑项目属性

项目组管理员

编辑项目组属性增加成员添加／删除项目设置项目组管理员删除项目组更改成员项目权限

---

Git @ OSC Flavored Markdown

---

Git @ OSC 的markdown基于原markdown做了一下扩展，具体使用如下。

You can use GFM in:

提交消息评论issuespull requests里程碑wiki 页面

跟传统的Markdown的区别

URL 自动链接

插入的URL不需要做特殊处理，会自动变成链接。

Emoji表情

支持Emoji表情，参考：Emoji cheat sheet

插入代码片段

可以向如下这种方式插入代码片段，可以在标记后面指定编程语言，如果没有指定语言，编译器会尝试自动识别。

```ruby require 'redcarpet' markdown = Redcarpet.new("Hello World!") puts markdown.to_html ```

将会变成

require 'redcarpet' markdown = Redcarpet.new("Hello World!") puts markdown.to_html

特殊的 码云 引用。

GFM 可以识别一些特殊的标记，并且支持自动补全，例如：

#123 （Issue）!123 （Pull Request）commit:1234567 （提交）:icon: （emoji 表情）

如何导入外部的Git仓库？

因为一些原因暂没有开放一键导入功能。有需求的可以先按照如下步骤导入其它地方的git仓库（以 github 上的 impress.js 为例）：

1. 从原始地址 clone 一份 bare 仓库：

git clone --bare https://github.com/bartaz/impress.js.git

2. 在 码云 上 创建一个项目

3. 以 mirror 的方式把刚才 clone 的项目 push 到 码云 上： （如果提示输入 git 用户密码，请到 http://gitee.com/keys 添加 SSH Key）

cd impress.js.git git push --mirror git@gitee.com:username/impress-js.git

这种方式的好处是：可以完整地保留原项目的所有 branch 和 tag 信息。提示:首次push内容量较大，推荐采用ssh方式push，传输更快，更稳定，如果项目较小，也可以采用http方式push。

更多导入办法，请点击这里

项目组的使用

项目组可以使用户更加方便的添加用户到项目中

1. 创建项目组：http://gitee.com/teams/new

2. 添加用户：可以设置两种权限，一种是用户默认在项目中的权限，一种是项目组管理权限

3. 指派到项目：如果选择开发者，那么将会按照用户在项目组中的默认权限为项目添加；如果选择管理员，那么项目组中的所有成员将会成为项目的管理员

4. 撤销项目：撤销项目将会把在项目属于项目组中的成员移除，如果成员同样存在于此项目别的项目组中，那么将会更新为别的项目组中的相应的项目权限。

Tips

项目组只有项目组的成员可以访问

项目组的名称是全站唯一的

一个用户存在于两个项目组a，b中，在a中的项目权限是管理员，在b中的项目权限是开发者，如果项目组a，b同时指派到项目pro，那么将项目组a从pro中移除之后，此用户在pro中的权限将会从管理员降为开发者。

README 规则

1. 码云 README 文件支持多种文件格式以及命名规则。

例如： README, README.md, README.org...

或者： README_zh.md, README_en.md...

2. 若有多个README文件，则优先显示文件名包含'_zh','_cn'等中文标注的README文件。

例如同一目录包含两个README文件：README_en.md README_zh.md

则显示README为： README_zh.md

改写历史，去除大文件

git filter-branch --tree-filter 'rm -f path/to/large/files' --tag-name-filter cat -- --all git push origin --tags --force git push origin --all --force

详细参见：这里

继续阅读

你可以点击这里阅读权威的git书籍ProGit

以下为收集的开源中国社区热心网友制作的码云跟各种IDE，软件的集成办法，可以点击查看：

eclipse中egit插件使用-图文并茂-详细

Visual Studio 2012连接到osc@git

TortoiseGit配合msysGit在码云代码托管的傻瓜教程

利用eclipse的git插件EGit与码云交互

Git初体验

在win7系统下使用TortoiseGit(乌龟git)简单操作码云

Xcode连接git @ osc

码云(git)中team开发、fork和pull request的用法

eclipse的git插件整合码云

Eclipse使用EGit管理码云项目

如何导入外部Git仓库到中国源代码托管平台（码云）

https 方式使用码云设置密码的方式