代码故事年更节目

协作开发全指南

文章目录
  1. 1. 概览
  2. 2. Git
    1. 2.1. 安装 Git
      1. 2.1.1. 配置基本信息
      2. 2.1.2. 代理
    2. 2.2. 仓库
      1. 2.2.1. 克隆仓库
      2. 2.2.2. 向仓库推送更新
        1. 2.2.2.1. 通过 VSCode 向仓库推送更新
    3. 2.3. 进阶技巧
  3. 3. Markdown
    1. 3.1. Typora 基本配置
      1. 3.1.1. 图片保存位置
  4. 4. Python
    1. 4.1. 虚拟环境

本文力图全面介绍如何协作开发一个项目，包含 Git 从零开始入门、Markdown 基础使用与推荐的编辑器设置等内容。

概览

一个合作开发的项目，肯定会用到如下工具：

  • Git
  • GitHub
  • Markdown

其它的一些工具，比如 IDE 什么的，本文将按照酱瓜常用的工具来做演示。不过大同小异，用其他的工具应该也有类似的功能。酱瓜使用的其它工具如下：

  • IDE：Visual Studio Code
  • 操作系统：Windows 10

Git

本章节介绍如何使用 Git。

安装 Git

从官网下载 Git for Windows 安装包，一路下一步即可。

配置基本信息

在桌面空白处右键，选择「Git Bash Here」打开 Git 终端。输入：

1
2
git config --global user.name "你的名字"
git config --global user.email "你的邮箱@example.com"

注意，名字最好填 GitHub 上的用户名，邮箱填 GitHub 的注册邮箱。

代理

因为 GitHub 时常遭受网络干扰，我们需要给 Git 设置代理。

下面以 Clash for Windows 为例，代理端口开在了 7890。

1
2
git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890

对于使用其它代理软件的朋友，配置大同小异，可以参考着配。

仓库

克隆仓库

在 GitHub 中可以得到仓库的地址：

仓库地址

在 Windows 资源管理器中打开工作目录，右键 - Git Bash Here，并在终端中输入：

1
git clone https://github.com/torvalds/linux.git

即可。

其中，长长的链接可以右键粘贴，也可以按快捷键 Shift + Insert 来粘贴。

向仓库推送更新

酱瓜推荐初学者使用 VSCode 内置的 Git 管理界面来进行更新。

通过 VSCode 向仓库推送更新

比如我们对仓库的一些文件做出了修改：

image-20220122115044169

在左上角提交信息处简单写上这次提交主要修改了什么：

image-20220122115158694

点击文本框上方的对勾即可。

此时观察到屏幕下方出现了「存在未上传提交」的提示：

image-20220122115310509

那个 1↑ 就是说有 1 个未上传的提交。点一下，同步图标会转起来，代表正在上传到 GitHub 上了。

进阶技巧

请参考下方链接：

Markdown

酱瓜使用的 Markdown 编辑器是 Typora。

Typora 基本配置

图片保存位置

请参考下图设置。

Typora 图片设置

Python

虚拟环境

创建虚拟环境：

1
python -m venv env

Windows 10 及以后的版本中，会遇到「在此系统上禁止运行脚本」的错误，解决方法：组合键 Win+X，选择「Windows PowerShell（管理员）」（Windows 11 下为 Windows Terminal），执行 set-executionpolicy remotesigned。