使用码云和博客园学习简易教程

使用码云和博客园学习简易教程

有了《使用开源中国（码云）托管代码》和《使用博客园进行学习》, 不少同学可以使用使用码云和博客园来学习了，也有不少同学还是误用。我以一周的学习过程为例，写一个step by step的教程。

我们以Linux（Ubuntu）环境下的学习为例，需要你掌握别出心裁的Linux命令学习法中的内容。

首先在Ubuntu中安装配置git，user.name中最好有学号信息:

sudo apt-get install git
git config --global user.name "20155200rocedu"  
git config --global user.email "rocedu@qq.com"

我在码云上建立了课程组织BESTI.IS.Java2017,大家可以在组织中创建自己的学习项目:

现在助教和课代表已经是管理员了，参考2016-2017-2 《Java程序设计》课程学生博客和代码托管链接尽快把同学们加为“开发者”：

我们可以在组织中通过点击“新建项目”建立自己的学习项目了，项目名称中一定要体现学号信息，语言和.gitignore都选择Java：

建好的学习项目如下图所示：

我们在Ubuntu中通过git clone https://git.oschina.net/bestiisjava2017/ljp20155200_JavaProgramming.git 来克隆我们的学习项目，
需要注意的是，项目链接有两种方式HTTPS和SSH两种，我们选择复制HTTPS的链接，这样不需要公私钥对，只要码云的用户名和口令就行了。想用SSH的可以自己学习。

如上图，参考《Java学习笔记(第8版)》学习指导建立教材学习项目目录，我们先使用mkdir src,mkdir bin建立src和bin目录。我们通过vi src/Hello.java或atom src/Hello.java编辑代码，输入以下程序：

1 public class Hello {
2     public static void main(String []args){
3         System.out.println("Hello Java World!");
4     }
5 }

下面我们编译运行Hello.java程序。最简单的办法是到src目录中使用javac Hello.java,Java Hello进行编译和运行。这时Hello.java和Hello.class都在src目录中，如下图我们通过javac -d bin src/Hello.java把Hello.class产生在bin目录中，通过cd bin,java Hello,cd ..来运行Hello.class 并保证工作目录是项目根目录：

代码编译运行没有问题了，我们通过git add .,git commit把刚才的工作纳入版本控制，通过"git push"把我们的工作推送到码云上。

到码云上 我们可以看到本地的代码和脚本已经上传到网站上了。

编译运行我们可以通过vim run.sh写一个脚本简化，以后可以使用Ant,Gradle等让编译自动化。

#!/bin/sh

javac -d bin src/Hello.java
cd bin
java Hello
cd ..

注意要用chmod +x run.sh给脚本加上执行权限。脚本测试没有问题，我们使用git add .,git commit -m "add run script" 把脚本纳入版本控制中。

我们使用vim src/Hello.java编辑Hello.java代码，加入一行打印己学号姓名的代码：

1 public class Hello {
2     public static void main(String []args){
3         System.out.println("Hello Java World!");
4         System.out.println("Hello 20155200 rocedu!");
5     }
6 }

通过脚本进行编译、运行的结果如下：

没有问题，我们使用git add .,git commit -m "print student id and name" 把新加代码提交到版本控制系统中。

这样，参考积极主动敲代码，使用JUnit学习Java中的学习方法就可以进行实践学习了。遇到问题参考《使用JDB调试Java程序》，《Intellj IDEA 简易教程》进行调试。

我们每周的学习要通过在博客园发博客，码云 也是博客写作，预览的好平台，同时也把博客的写作纳入了版本控制。

我们先运行mkdir docs,touch docs/java_homework_week1.md创建docs目录和空文件“java_homework_week1.md”。

我们通过git add ., git commit -m "init docs with empty java_homework_week1.md"把作业博客纳入版本控制。

我们通过git push把作业推送到码云 上：

在码云 上我们看到了docs文件夹：

点击docs文件夹，打开“java_homework_week1.md”，点击“编辑”就可以写作业了：

为了规范作业，我在2016-2017-2 《Java程序设计》教学进程中给出了作业模板的Markdown 内容，作业提交要严格按模板提交，我们先把模板拷贝过来，并进行提交：

提交说明是“拷贝作业模板”，这等价于 git commit -m "拷贝作业模板", 点击“提交到master”按钮。

要养成写一段完整文档提交一次的习惯。

作业模板包含以下要素，不要遗漏:

• 教材学习内容总结
• 教材学习中的问题和解决过程
• 代码调试中的问题和解决过程
• 代码托管
• 上周考试错题总结
• 其他（感悟、思考等，可选）
• 学习进度条
• 参考资料

我们给几个简单的例子，点击“编辑”：

首先把标题中的“学号”改成自己的学号，方便老师识别作者，然后把“第X周”改成“第一周”

要注意模板中“教材学习内容总结”，以前不少同学写作业在此浪费了大量时间，写总结要：

• 尽量简单的总结一下本周学习内容
• 尽量不要抄书，浪费时间
• 看懂就过，看不懂，学习有心得的记一下

这样才能体现差异化，当然你也可以预测老师会考什么，在此列出来备查，一定不能长篇大论，内容却千篇一律。
比如我们总结出了三个要点，在提交信息中写“完成学习要点”，然后点击“提交到master”按钮。

我们的学习模板参考了邹欣老师(博客,微博,豆瓣)设计的进度条，进度条用好对学习的促进作用非常大的，实践一年来效果不太好，主要各种原因造成学习数据乱填。

为此我设计了一节“代码托管”，要求学生有两个截图：

• 代码提交过程截图：运行 git log --pretty=format:"%h - %an, %cd : %s" 并截图
• 代码量截图：运行 find src -name "*.java" | xargs cat | grep -v ^$ | wc -l 并截图

后来我写了个脚本直接把这个过程自动化了：

#!/bin/sh
clear
echo "//==========Today====================================="
echo "code summary infomation:"
find . -name "*.java" -mtime 0 | xargs cat | grep -v ^$ | wc -l 
echo "documents summary infomation:"
find . -name "*.md" -mtime 0 | xargs cat | grep -v ^$ | wc -l 
echo ""

echo "//==========This Week================================="
echo "code summary infomation:"
find . -name "*.java" -mtime -7| xargs cat | grep -v ^$ | wc -l 
echo "documents summary infomation:"
find . -name "*.md" -mtime -7| xargs cat | grep -v ^$ | wc -l 
git log --pretty=format:"%h - %an,%ci: %s " | grep  `date +%F --date="-0 days"`
git log --pretty=format:"%h - %an,%ci: %s " | grep  `date +%F --date="-1 days"`
git log --pretty=format:"%h - %an,%ci: %s " | grep  `date +%F --date="-2 days"`
git log --pretty=format:"%h - %an,%ci: %s " | grep  `date +%F --date="-3 days"`
git log --pretty=format:"%h - %an,%ci: %s " | grep  `date +%F --date="-4 days"`
git log --pretty=format:"%h - %an,%ci: %s " | grep  `date +%F --date="-5 days"`
git log --pretty=format:"%h - %an,%ci: %s " | grep  `date +%F --date="-6 days"`
echo ""
echo ""

echo "//==========All================================="
echo "code summary infomation:"
find . -name "*.java"| xargs cat | grep -v ^$ | wc -l 
echo "documents summary infomation:"
find . -name "*.md"| xargs cat | grep -v ^$ | wc -l 
echo "commit history:"
git log --pretty=format:"%h - %an,%ci: %s "

在“代码托管”部分贴这个脚本的截图就可以了。可以看出自己每天，本周，这学期写了多少文档，多少代码。

“代码托管”的链接要改成自己的学习项目链接：

在码云上写的文档，要同步到自己的电脑上，只要运行git pull就行了。

我们运行一下"statistics.sh"脚本，我们可以看到自己的学习进度：

每周作业中要对这个结果截图，使用博客园的上传图片功能可以生成Markdown图片链接![](http://images2015.cnblogs.com/blog/741560/201703/741560-20170302072056626-389386440.png)

我们把这个链接插入码云上的作业博客中：

完成了本周学习任务，我们可以通过“一键复制” 把作业博客的内容复制，然后去博客园班级中去提交作业了.

最后，完成本周的学习任务，一定要运行git push 就可以把本周学习成果推送到码云上。

总结一下我们课上的git使用流程是：

• 在码云上建立教材（个人项目，团队项目）项目目录

  • 使用git clone https//... 克隆学习项目

• 作业博客可以在码云上完成,纳入版本控制

  • 使用git pull可以把码云上的文档同步到本地PC上

• 平时学习，代码要在编译，运行，测试没有问题后进行如下操作

  • git add .
  • git commit -m "提交信息"

• 周末提交作业前

  • git push

git commit -m "提交信息"中提交信息的写法参考《Commit message 和 Change log 编写指南》，最重要的一点是「One Thing One Commit」,不要写了一周的代码，周末提交一次，所有代码的msg都是「第XX周代码」

更多学习参考

一定要注意，这个教程教你如何在第一周就可以使用git和博客园来完成学习，git的使用和背后的原理还要多多学习。

上课学习流程参考代码驱动的程序设计学习.

代码推送参考Ubuntu下git的安装与使用

团队项目参考使用GitHub进行团队合作.

---

欢迎关注“rocedu”微信公众号(手机上长按二维码)

做中教，做中学，实践中共同进步！

---

• 原文地址：http://www.cnblogs.com/rocedu/p/6482354.html

• 推荐网站：博客园、新浪微博、扇贝背单词、DKY背单词小组、有道云笔记、豆瓣读书

• 版权声明：自由转载-非商用-非衍生-保持署名| Creative Commons BY-NC-ND 3.0

---

如果你觉得本文对你有帮助，请点一下左下角的“好文要顶”和“收藏该文”

---