- 前言:

**本文件僅供學習記錄用，並無解析相關細節，
只適合完全無經驗的新手觀看流程，還請多多指教 :D。**

### 前置作業：

- 使用「終端機」、「Visual Studio Code」、「一個 Github 帳號」。

### 創建 repo

- 首先，到自己的 github 主頁，右上角有一個圖示 "+" 點開來建立
你的新「repository」。


### Create a new reposirory

- 創建，儲存庫名稱又稱「倉庫名稱」。

// 由於是初學的情況下，不用太糾結命名規範。
- 這邊我會輸入 "newrepo"


### 選擇你的儲存庫建立方式，有兩種:

- A. …or create a new repository on the command line:

這個方法適用專案是「新開的，尚無檔案」，且完全沒有同步的情況下。

- B. …or push an existing repository from the command line

這個方法適合專案已經有在本地端開發中的情況下。

### 初次使用，走A流程:

1. 打開終端機，創建資料夾 or 找到目的地資料夾：
- **這邊我採取完全沒開啟資料夾的情況下來作業**

2. 我個人習慣先輸入 ls，目的是用來觀看我當前處在什麼位置。
輸入了以後會產生下列結果:
(從這邊我很確定我不是在 Desktop)。

ls

3. 指定到目的地，這邊以「桌面」為例：
- 這邊有一個小技巧， cd + 空白輸入目標時，不需要打完「全部名稱，只需要 Tab 就會自動帶入目標路徑。操作上相當容易。

cd Desktop/

4. 創建資料夾，於當前的目的地：
- mkdir + 你取的資料夾名稱

mkdir repofloder

5. 這時候可以再輸入指令一次「ls」用來查看桌面是否真的成功創建資料夾：

- ok，這邊確實看到了 repofloder


ls

6. 指定路徑到新創建的資料夾，從這邊進入到「編輯器」：

cd repofloder

7. 進入文字編輯器
- 這個動作會直接使電腦的 Visual Studio Code 被開啟
且左上角會發現，資料夾名稱一樣。


code .

### 文字編輯器 & github 倉庫同步操作流程階段：

- 從這兒開始，就是透過 Visual Studio Code 來操作指令。

### 開啟上方的終端機 -> 新增終端：

- 初次使用，我們會輸入兩道指令，來觀看一些資訊。

1. 在本地文件夾中初始化一個新的 Git 儲存庫。

git init

2. 檢查遠端儲存庫的連接狀態，這理論上是不會報錯誤的。

git remote -v

- …or create a new repository on the command line
回到前面的方法 A. 並複製貼上其指令：

echo "# newrepo" >> README.md
git init
git add README.md
git commit -m "first commit"
git branch -M main
git remote add origin https://github.com/WilsonCode1224/newrepo.git
git push -u origin main

### 產生一個新的檔案，touch

- 語法如下：

1. // 這邊的 "." 代表著檔案名稱
touch .   


2. // 我們嘗試建立一個 .gitignore
   
*解釋: gitignore，這個文件用於定義哪些文件和資料夾應該被 Git 忽略，
以避免將它們納入版本控制。*   
   
touch .gitignore

- 建立好了以後，在左邊的檔案區會發現，我們已建立好 .gitignore。

### 到 .gitignore 輸入要忽略的檔案類型：

*.env // 練習時輸入的，可忽略
.DS_store // 必刪除 (實際要刪除的)

- 對現有的檔案做了修正要使用的指令：

git add .

// 例如我們在 .gitignore 輸入了內容(即表示有做修正)，則需輸入：


git add .gitignore

### [習慣]創建好的檔案，要更新指令(歷史紀錄的概念)

- ""內容可以按照實際情況去記錄我們更動了什麼東西。

git commit -m "add new file"

- 輸入 git push

git push

- 基本上做到這邊就是完成提交了，可以到 github 上看是否有同步。