【教程】在VSCode中使用碼雲進行代碼管理
前言
本教程核心內容
本文主要是整合了網上教程,
從Git安裝開始,配置關聯本地倉庫到碼雲,最終用上VScode這個流程。
非常基礎和簡單,照着操作就行了。
起因
平時常寫python腳本,原先用Sublime,現在用VScode,發現編輯器左側有代碼管理這個按鈕,於是開始找怎麼設置VSCode能和碼雲連在一起。
踩了一些坑,理順了思路,才發現一點關係都沒有。
正確的思路是:安裝Git;關聯碼雲;打開VSCode。
是的你沒看錯,前兩步設置好了,打開VSCode直接就能用上碼雲的代碼管理了。
Git和Github的關係:
- Git是一個分佈式的版本控制系統,只是軟件,需要你下載裝到電腦上,實現git功能。
- Github、BitBucket、Gitee基於git的項目託管平臺,說白了是雲服務器或雲盤,存儲分享你的代碼,查看追更別人的代碼。 理解了這些,大概就能明白有一堆程序員所在的Github爲什麼被戲稱是全球最大的同性交友平臺這個梗了。Github、BitBucket是國外的,連接速度因人而異;另外Github收費用戶才能創建私有項目。
準備內容
- 註冊碼雲(Gitee),創建一個項目,得到項目url:
https://gitee.com/YourGiteeName/projectname
- 下載git安裝, 全都按下一步就行了。
- 下載VSCode安裝。
如何生成ssh公鑰
打開Git Bash,安裝完git就有這個了。
你可以按如下命令來生成 sshkey:
ssh-keygen -t rsa -C "[email protected]"
# Generating public/private rsa key pair...
# 三次回車即可生成 ssh key
查看你的 public key
cat ~/.ssh/id_rsa.pub
# ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC6eNtGpNGwstc....
打開碼雲SSH公鑰管理頁面 https://gitee.com/profile/sshkeys
填寫標題:yourname's SSH key
公鑰:ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC6eNtGpNGwstc...
添加後,回到Git Bash中輸入
ssh -T git@gitee.com
如果有彈出詢問(yes/no)
,輸入yes
若返回
# Welcome to Gitee.com, YourGiteeName!
則證明添加成功。
Git操作
初始化Git
首先,你需要執行下面兩條命令,作爲 git 的基礎配置,作用是告訴 git 你是誰,你輸入的信息將出現在你創建的提交中。
git config --global user.name yourname # "你的名字或暱稱"
git config --global user.email youremail@xxx.com # "你的郵箱"
創建版本庫
什麼是版本庫呢?版本庫又名倉庫,英文名repository,你可以簡單理解成一個目錄,這個目錄裏面的所有文件都可以被Git管理起來,每個文件的修改、刪除,Git都能跟蹤,以便任何時刻都可以追蹤歷史,或者在將來某個時刻可以“還原”。
所以,創建一個版本庫非常簡單,首先,選擇一個合適的地方,創建一個空目錄YourProjName(名字任意):
cd /e/
mkdir YourProjName
cd YourProjName
如果你使用Windows系統,爲了避免遇到各種莫名其妙的問題,請確保目錄名(包括父目錄)不包含中文。
第二步,通過git init
命令把這個目錄變成Git可以管理的倉庫:
git init
# Initialized empty Git repository in E:/YourProjName/.git/
瞬間Git就把倉庫建好了,而且告訴你是一個空的倉庫(empty Git repository),細心的讀者可以發現當前目錄下多了一個.git
的目錄,這個目錄是Git來跟蹤管理版本庫的,沒事千萬不要手動修改這個目錄裏面的文件,不然改亂了,就把Git倉庫給破壞了。
關聯
本段內容大部分引用自碼雲平臺幫助文檔V1.2 Git 常用命令與名詞解釋
把一個本地倉庫與一個雲端Gitee倉庫關聯。
項目地址形式爲:https://gitee.com/YourGiteeName/YourProjName.git
或者 [email protected]:YourGiteeName/YourProjName.git
git remote add origin https://gitee.com/YourGiteeName/YourProjName.git
其中origin
代表的是你遠程的倉庫,習慣如此命名,可以通過命令 git remote -v
查看
git remote -v
# origin https://gitee.com/YourGiteeName/YourProjName.git (fetch)
# origin https://gitee.com/YourGiteeName/YourProjName.git (push)
如果你想克隆一個項目,只需要執行:
git clone <項目地址>
同步(拉取)
同步,也可以稱之爲拉取,在Git中是非常頻繁的操作,和SVN不同,Git的所有倉庫之間是平等的,所以,爲了保證代碼一致性,儘可能的在每次操作前進行一次同步操作,具體的爲在工作目錄下執行如下命令:
git pull origin master
master
是分支名,如果你本地是其他分支,請換成其他分支的名字,另,因爲遠程倉庫與你本地倉庫可能存在衝突,故當存在衝突時,請參考進階篇的如何處理衝突
查看文件夾,會發現 Gitee倉庫上 README.md 文件被下載回來了。
提交
git作爲支持分佈式版本管理的工具,它管理的庫(repository)分爲本地庫、遠程庫。
這裏我們把 add(暫存)、提交(commit)、推送(push),放到一起說,因爲每次上傳代碼都需要執行這三步(關於衝突處理、分支合併等以後用到了再研究,本文只說基礎部分)。
git add # 加入到暫存區
git commit # 提交到本地庫
git push # 發送給遠程庫
首先,我們打開 README.md ,在裏面稍稍加上幾個字,保存。這樣文件就做了修改。
再來查看git狀態
git status
# On branch master
# Changes not staged for commit:
# (use "git add <file>..." to update what will be committed)
# (use "git checkout -- <file>..." to discard changes in working directory)
#
# modified: README.md
#
# no changes added to commit (use "git add" and/or "git commit -a")
會提示你modified: README.md
,意思是這個文件被修改了。no changes added to commit
是說目前暫時沒有文件放到暫存區。
所以我們將文件加入暫存區。
git add -A
-A表示將所有文件的修改,文件的刪除,文件的新建,都添加到暫存區。
然後提交到本地庫,並附加註釋。
git commit -m "第一次提交"
# [master 1cc3dd5] 第一次提交
# 1 file changed, 1 insertion(+), 1 deletion(-)
-m後面的是本次提交的說明,通常可以備註你改了什麼,便於以後翻看歷史記錄時,能直觀知道這是哪個版本,這個版本改了些什麼東西。
最後推送到遠程庫,也就是Gitee上的項目裏。
git push origin master
# Counting objects: 3, done.
# Writing objects: 100% (3/3), 297 bytes | 297.00 KiB/s, done.
# Total 3 (delta 0), reused 0 (delta 0)
# To https://gitee.comYourGiteeName/YourProjName.git
# 5464c11..1cc3dd5 master -> master
Git Gui
上面說的都是代碼上的操作,實際上安裝完Git之後,也有GUI界面可以直接使用。
打開 Git Gui,選擇Open Existing Repository
,找到剛剛創建的本地庫打開。
界面比簡單,只有幾個按鈕:
Rescan
檢查倉庫中文件狀態; Stage Changed
就是add暫存; Commit
、Push
就是提交、推送。
注:如果發現中文亂碼,我們修改一下配置文件編碼,改爲utf-8就好了
git config --global gui.encoding utf-8
VSCode
點擊 文件 > 將文件夾添加到工作區 > E:/YourProjName/
就完成了。
無需任何配置,VSCode自動獲取.git配置實現代碼管理: 發生變動的文件或代碼會有顏色提示,而且可以對比前後改了哪些地方。
需要上傳的時候:
點擊+
號,加入暫存;
在[ 消息 (按 Ctrl+Enter 提交) ]
中輸入commit註釋;
點擊同步圖標,push出去。