---
# System prepended metadata

title: Git 新手入門 - 初次上傳專案到 Git hub
tags: [git 學習歷程]

---

- 前言:

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

### 前置作業：

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


### 創建 repo

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

![](https://hackmd.io/_uploads/rJTweYEn2.png)


### Create a new reposirory

- 創建，儲存庫名稱又稱「倉庫名稱」。
 
```
// 由於是初學的情況下，不用太糾結命名規範。
- 這邊我會輸入 "newrepo"
```

![](https://hackmd.io/_uploads/HJWpZYVnn.png)


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

- 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)。
   ![](https://hackmd.io/_uploads/HJscStNhn.png)

```
ls
```

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

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

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

- ok，這邊確實看到了 repofloder

![](https://hackmd.io/_uploads/ByyEwFNhh.png)


```
ls
```

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

```
cd repofloder
```

7. 進入文字編輯器
   - 這個動作會直接使電腦的 Visual Studio Code 被開啟
     且左上角會發現，資料夾名稱一樣。
     
     
![](https://hackmd.io/_uploads/BJTQtFV2h.png)
     
     
```
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 上看是否有同步。

![](https://hackmd.io/_uploads/BypxP9Nh2.png)


