美文网首页工具@产品程序员
用Git记录成长轨迹 | 写给小白的工程师入门

用Git记录成长轨迹 | 写给小白的工程师入门

作者: 思南说 | 来源:发表于2017-09-05 00:47 被阅读2050次
    题图:pexels

    这是我面向小白写的 Python 编程教程的第二篇(第一篇请点这儿)。拿勺子同学当小白鼠讲过一遍后,就把修改完的讲义发上来啦。

    和勺子上课时,我意识到,不和新手交流的话,离出发点越远的人就越不可能记得自己当初学习笨拙的样子。但事实是:谁都是那样开始的。所以就算你要花几天时间才能完成这篇教程的内容,也不要觉得自己太笨太慢,毕竟每天都能进步一点点就已经很可贵了。

    如果你认可这篇教程的价值,欢迎分享到朋友圈,分享给更多人!有看不懂的地方也可以留言。越多关注,作者就越多动力及时更新呐😊

                  第2节 用 Git 记录成长轨迹

    macOS 版本

    因为简书编辑页面代码不友好,没有代码块格式也无语法高亮,我只能用引用格式代替。产生混淆的地方请读者到原文(见留言)查看完美编辑版 :P

    a. Git 是什么?

    关于 Git,有这么一个浪漫的说法——“工程师的时光穿梭机”。

    我以前在公司实习时,老板总会说,"Don’t worry. You won’t break anything (because we have git!)

    如此神奇的 Git 其实是一个版本控制(Version Control System, VCS)工具,可以用它来快速有效地管理成千上万个文件(不止是代码)的历史版本与进度。对于编程小白来说,Git 是个全新的概念,完全理解并掌握需要时间加练习,这篇教程就会带你完整走完“安装 - 设置 - 使用 Git”一条龙学习体验。

    顺便提一句,“可以熟练使用 Git”是值得写在求职简历上的程序员技能哦!跟着这篇教程走几遍,完成课后作业,就可以让你的简历再添亮点。

    b. 安装并设置 Git 运行环境

    ❍ 安装 Git

    查看电脑是否已经提前安装了 Git,在 Terminal 中输入:

    git --version

    若返回 git version xx.xx.x (xx代表数字) 则说明电脑已经安装 Git,否则就需要跟着下面几步先安装 Git,继续在 Terminal 内输入:

    brew install git    # 这里假设读者已按第1节教程安装了 Homebrew,否则请返回第1节安装

    brew link git


    ❍ 设置 Git 运行环境

    第一步,先设置通用的用户名与邮箱(与你的 GitHub 账号信息相同):

    git config --global user.name "Sinan Tang"                    # 注意引号

    git config --global user.email tangsinan92@gmail.com  # 要替换成你自己的名字与邮箱…

    如果没问题的话,输入下面两行检查刚才的设置是否成功:

    git config user.name

    git config user.email

    若返回了你输过的用户名与邮箱,则说明设置成功。

    为什么要设置用户名与邮箱呢?为了今后每次你用 Git 提交改动 (commit) 时都会自动刻上你的个人信息,这个是无法改变的(指不能改变某次改动的作者,而非不能改变 Git 的用户名或邮箱)。

    c. 利用 GitHub 创建永不丢失的个人作品集

    ❍ 什么是 GitHub?

    上面以非常简短的篇幅介绍完 Git 基本知识后,让我们再来看看 GitHub 与Git 的关系。

    Git 是一个版本管理工具(VCS tool),可以在命令行(command line)使用,可以在许多IDE内使用(比如PyCharm),也可以在网站使用——这个网站即为GitHub,是更加直观的Git 操作界面(web-based Git)与项目托管网站。从这三种途径进行的操作大多数时候可以相互替代。我一般用命令行来运行 Git 指令——虽然对于新手来说命令行不如网站界面那么直观,但熟悉后会发现命令行比网站方便快捷很多。

    有时 GitHub 这个名称会让人困惑,因为创建 Git 与 GitHub 网站的公司也叫 GitHub。并且 GitHub 这个名称常用来指代基于 GitHub 的开发者社区——一个工程师们的主流社交网站!

    GitHub 值得聊的趣闻轶事太多,这里就不占用过多字数,先把正事搞定!

    ❍ 为什么要提交代码到 GitHub?

    在讲具体操作前,来简单介绍下积极利用 GitHub 的好处。

    有些IT公司招聘工程师时,会要应聘者的 GitHub 账号,目的是查看应聘者在 GitHub 上的真实贡献值(contribution activity) 和参与项目。如果你不是很清楚那是什么的话,可以参考下面我之前实习参与公司项目不到五个月的贡献值截图:

    中间像日历一样的灰网格区域即为我提交代码的贡献值记录,深浅不一的小绿块儿代表了代码提交次数——越深提交越多。因此,当别人看到你的 GitHub 个人主页时,就能一目了然看到从你加入 GitHub 之后每天的贡献值。

    正因为 GitHub 上的贡献值记录很难造假,所以对于工程师来说,GitHub 才是最真实的个人简历(不过听说国内有些程序员为了求职会去 GitHub 提交假项目……sigh)。


    ☺︎ 以下操作建立在读者已申请好一个 GitHub 账号的假设上——还没账号的请先去 https://github.com 申请哦!

    ❍ 创建 Git repository,克隆项目到本地

    在上一节已经初步学会使用 PyCharm 的基础上,我们来看看如何在 PyCharm 中编程,并通过 Terminal 把代码改动提交到 Git 上。

    安装了 PyCharm 后,会在电脑上自动生成一个文件夹叫 PycharmProjects,在 Finder 里找到它,在 Terminal 中打开。

    要想在 Terminal 内打开某个文件夹,除了第1节提到过的“复制该文件夹 - 粘贴到 Terminal 内cd指令之后”之外,还可以:

      ❍ 设置快捷键:去往System Preferences > Keyboard > Shortcuts > Services > Files and Folders,找到一个选项叫“New Terminal at Folder”,启用它并把后面的快捷键改成更顺手的键盘组合,比如我改成了⌃⌥⌘T(T for Terminal)。每次只要选中一个文件夹,再按⌃⌥⌘T就可以很快在 Terminal 内打开啦!

      ❍ 右键点击:当你启用了“New Terminal at Folder”后,可以右键点击一个文件夹,点击跳出菜单的最后一行“New Terminal at Folder”

    直接用快捷键呼出 Terminal 的方法最快捷(= 最像工程师),推荐! 

    然后在 Terminal 中输入:

    git init        # init = initialise 初始化

    这一步会在 PycharmProjects 内创建一个你看不到的文件夹 .git,里面包含了所有你在本地使用 Git 的所需文件。

    接下来,打开 GitHub 官网,登陆你的账户,在首页右下方有个窗口叫“Your repositories” (你的项目,有人翻译成“库”,但我觉得不如“项目”易于理解),右边有个绿色按钮“New repository”,点开,在设置页面给这个项目取个名(Repository name),选择“Public”,选中”Initialize this repository with a README”,最后点击“Create repository”。这样你就拥有了自己的第一个 GitHub 项目!

    在新建项目的主页,找到页面右端一个写着“Clone or download”的绿色按钮,点开,复制其中自动生成的 https 地址。

    现在回到刚才的 Terminal 中(依然在 PycharmProjects 的位置),输入:

    git clone https://github.com/SinanTang/xxxxx.git    # 网址部分替换成你刚刚复制的地址,注意不要把这里的网址范例贴上

    接下来等待 Terminal 内进度条完成的时间里,你可以去 PycharmProjects 文件夹中看一眼,应该会发现刚刚在 GitHub 新建的项目,已在这里出现了同名“克隆”文件夹——这个文件夹与 GitHub 上的 Repository 是一模一样的,你在本地修改文件夹内内容,提交后,就会自动同步到 GitHub 相关 Repo (repo = repository, 这是个极其常用的缩写) 上。

    创建并本地化一个 GitHub repo 的方法不止这一个,但实践下来,我认为这是最有利于小白上手的方法。

    ❍ 用 IDE (PyCharm) 与命令行提交改动到 GitHub

    现在用 Spotlight 呼出 PyCharm,出现的应该还是上一次随便玩玩的 project,点击上方任务栏File > New Project… > Pure Python,在Location一栏选中刚刚新建的项目名字,选择 Interpreter (即 Python 2.7 或 Python 3.6),最后点击Create.

    顺利的话,此时窗口左侧已经变成新项目的名称了。按第1节里写过的新建 Python 脚本的方法,现在在此目录下新建一个 test.py,在空白脚本里写下这句我们现在已经非常熟悉了的:

    print("Hello World")            # Python 3.6

    在 PyCharm 内敲击 ⌘9,下方会跳出 Version Control 框,在 Local Changes 这儿你能一眼看到自己改动/添加/删除了哪些文件。你还可以点第二个 Log 标签,猜猜这儿是用来展示什么的?答案一会儿揭晓。

    现在回到 Terminal 内,确认已位于新项目的位置(需要 cd 到该项目),输入:

    git status           # 查看目前的 git 状态

    可能需要输入 GitHub 邮箱与密码。

    接着会返回一堆信息,看看刚刚添加的 test.py 是不是也在其中呢?我们现在就来提交它。接着输入:

    git add -A                                      # 把所有改动都添加到“暂存区”

    git commit -a -m "initial commit"   # 提交所有暂存的改动,引号内填写此次提交的解释说明

    git push origin master                   # 将改动推送到服务器

    git log                                            # 查看提交历史,如果成功会在这里看到

    git status                                       # 再次查看 git 状态,当所有改动都已推送到云端后,这里会出现“nothing to commit, working tree clean”的信息

    第三步 git push 在第一次提交改动时或许会返回信息需要你单独设置些参数, 但以后一般情况下只需输入 git push 即可。

    为了加深小白对 add / commit / push 提交改动三步曲的理解,我找到了下图——

    参考:http://rogerdudler.github.io/git-guide/index.zh.html

    现在回到 PyCharm 内,看下方 Local Changes 区是不是变成空白了?再点右边的 Log 标签,和刚刚不太一样了吧?是不是出现了一个名为”initial commit”的新“节点”,进度树向上生长了一节?

    再回到 GitHub 网站,你的新项目应该已经和本地改动同步了,你可以在这个 Repo 的 commits 页面看到你刚刚在 Terminal 进行的操作。

    第2节 - 作业

      ❍ 拓展阅读:Pro Git book by Scott Chacon and Ben Straub ( https://git-scm.com/book/en/v2 ) (推荐阅读英文书,不过页面也有中译本可选) 

      ❍ 从 GitHub 体验官升级为真正用户:去 GitHub 主页,点击上方 Explore,在 Trending 里翻翻最近的流行项目与牛人。 

      ❍ 有个 GitHub 项目专门帮工程师一键生成 GitHub 个人简历,你也可以去玩玩 ( http://resume.github.io )。虽然现在还没有东西可以展示,但将来总会有的嘛!

    第2节 - 小结

    这节课我们简单了解了一种主流版本管理工具 Git 与工程师的社交网站 GitHub,创建了第一个 GitHub 项目,并使用 IDE 与命令行第一次提交了代码改动!一切都才刚刚开始。

    推荐阅读:

    《写给小白的工程师入门 - 从 Python 开始》

    《文科女进德国IBM实习做程序媛,我是怎么办到的?》

    谢谢你的阅读!

    相关文章

      网友评论

      • Hello_kid:github主页上是您的照片吗? 每天都看一篇,啥时候更新呢,哈哈:smirk: 迫不及待学python啊
        不_一:您好,请问修改本地文件夹文件后后,怎么提交?使github上实现同步?
        思南说:@Ruiz678 那个之前公司内部的github主页,不过确实是我的照片。我努力写……谢谢阅读!
      • 思南说:对了 原文链接请看:http://bit.ly/2gPfJ73
      • MrLonelyZC88:直观感受是文字太多,很多操作有配图就好些
        思南说:谢谢建议
      • Captain_w:别人看您贡献度 只试用public项目吧.private项目在自己主页是看不了的吧
        Captain_w:@唐思楠Lynn 我试试
        思南说:@Captain_w 这个可以设置。可以把private也加进去
      • RUYES:妹子必须顶啊。:yum:
        思南说:@RUYES 谢谢!:smile:
      • duoduo7628:windows上有GUI。简书markdown有代码块。显示效果比csdn好太多。
      • Rokkia:问个题外话, 那个“创建 Git repository,克隆项目到本地” 前面那个圈圈是怎么打的。
        Rokkia:@唐思楠Lynn mac还有这操作? 我大概是个假的mac使用者:disappointed_relieved:
        思南说:@__鲸_ 用Mac输入法自带的特殊符号…
        则丸: @__鲸_ 试试评论
      • 心若冰清_:是有代码段的。你使用markdown编辑器啊。输入:
        ```
        代码
        ```
        就可以 了
        心若冰清_:@唐思楠Lynn 好事多磨
        思南说:@心若冰清_ 我终于在大家的提醒下迟钝地发现了……
      • 414697ada450:厉害了妹子

      本文标题:用Git记录成长轨迹 | 写给小白的工程师入门

      本文链接:https://www.haomeiwen.com/subject/tdiyjxtx.html