# VScode

:::info
:bulb: 電腦重灌紀錄重新安裝VScode~~~
:::

### :small_blue_diamond: **Date:2024-05-31**

### 1. 官網下載&安裝
按自己電腦的系統下載對應的版本，下載完直接點擊安裝，我有勾選桌面圖示~
我安裝的時候忘了截圖紀錄QQ

[VScode官網連結](https://code.visualstudio.com/)

### 2. Git
#### Git安裝
如果也是用VScode做IDE，打開VScode左邊的工具欄，打開Source control圖示，還沒有安裝Git會提醒你要先安裝，按下去應該就裝好了吧(??
不過我自己是在官網直接下載來安裝XD
[Git官網下載連結](https://git-scm.com/downloads)

下面這張圖是我裝好Git打開source control會出現的畫面

#### 為何需要Git
之後會需要做版本控制，或是使用到Github上面的程式時，一定用的到Git!
Git可以幫助我們自在的在每個檔案中紀錄更改的版本，不過我比較棘手的是要用github上的專案，所以一定要先裝好。

#### 連結Github帳號和VScode
上圖中點Clone Repository，會出現要給對應Github資料夾的URL，第一次用應該指引你要當入Github授權等等的步驟，畫面會跳開到網頁版的Github要登入，登入完成再回到VScode案右下角的確定連結上了

下次從VScode就可以打開看到連結好的Github帳號底下的專案。如果要使用其他人在Github上的專案，也可以直接手動或是用git指令clone到電腦上。


把網址貼到上面的search bar，會跳出要存放專案的資料夾，我喜歡把資料夾名稱設成 **[年份_專案名稱]** ，簡單明瞭!!

成功的話會像下圖，把Github專案原封不動的帶回VScode。


### 3. 編譯器Interpreter
如果你也是和我一樣剛裝好VScode，打開專案的main.py想要直接跑，一定是跑不起來的!!
因為你會和我一樣收到這個錯誤，沒有python的編譯器~~~~


選擇藍藍的按鈕**Select Python Interpreter**，畫面請帶到上面search bar!!!!

會要你選擇一個編譯器，就是執行python檔案(.py)的python本人，就像買了故事書，你也需要有說書人來唸才可以的概念

我以前覺得建立虛擬環境很複雜，我會直接下載可以跑這個專案的python，然後該下載甚麼工具包就下載!!!缺甚麼就補甚麼在我的base!!!!!後來我發現，每個專案要求的版本都不一樣，後來就會出車禍~
所以終於體會到虛擬環境的美好，幫每個專案裝潢好自己的房間，好好待在裡面 :)

所以這裡我就來創一個給這個專案的虛擬環境嚕
(這個專案是PINN，一個Tensorflow為基礎的神經網路)

點選 **Create Virtual Environment....**


我習慣用conda管理虛擬環境，包括建立、刪除、進入、退出和安裝工具包等等等等等


如果你還沒安裝好conda，(差點讓你們自己去找其他網站說明來安裝，結果我也還沒裝!!!重灌後啥米都沒有的電腦!!!!)，請點下面的網址進去下載~
[Conda官網](https://www.anaconda.com/download/success)
Conda是需要建立帳戶的，可以快速用Gmail登入~
下載完打開執行檔安裝~

裝好了Anaconda，這時候回到VScode打開terminal(search bar輸入terminal)，用powershell輸入指令:conda env list
![image] (https://hackmd.io/_uploads/SJ90pRU4A.png)

如果也出現跟我一樣的錯誤，代表也要去編輯環境變數~
在windows搜尋環境變數>進階>環境變數



接下來會看到下面這張圖，有兩個地方要編輯
1. User的使用者變數 : 點變數名稱Path按編輯，把三個anaconda相關的路徑加進去。
2. 系統變數 : 一樣點進去Path做和上面一樣的事



新增完環境變數後，重新打開VScode，重複剛剛打開conda的步驟~
terminal>powershell>輸入指令```conda env list```

沒有出現Error就是成功了!
現在輸入conda env list不會出現任何東西是正常的，因為我還沒有建立任何虛擬環境，理論上只會出現base

### 4. 建立虛擬環境

建立好conda之後，可以透過conda指令來管裡虛擬環境和tools。

在powershell輸入```conda create -n [你的虛擬環境名稱]```
中間會停下詢問，輸入```Y```繼續。

**[你的虛擬環境名稱]** : 通常可以跟著你的專案命名，然後簡單描述Python版本，如果是和別人共用server的話，建議可以在這個名稱中加入可以辨識你是誰的資訊，名字、工號或是英文代號
例如: py310_PINN_suzy

如果是在自己的電腦上就不用多加名字了，因為正常狀況下只有自己會使用到這台電腦，沒有共用問題~

如果要用的工具很單純是python，可以直接在創建虛擬環境時就指定python版本一起創建環境並安裝python，如:

不過我這裡是沒有這樣做~因為我要用另一個方法裝python!!   
虛擬環境建立成功會像下面這張圖:   

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


### 5. 安裝工具包  

目前我創了一個完全空的虛擬環境，想像是一個毛胚屋，啥都沒有的空屋!我們可以選擇手動用```conda install XXX```來安裝packages，但是如果你需要的工具包很複雜，常常裝到最後都有很多版本相容的問題，這種煎熬不是誰都能熬得過，呼籲大家不要闖~  
我覺得有兩種比較好的方法~  

#### 1.打開anaconda
直接用應用程式一個一個點選安裝，雖然這很像直接輸入指令，不過我自己試用覺得版本上他比較會選擇相融的工具包，然後人性化的GUI遇到不相容比較知道要怎麼操作。  

#### 2.Requirements.txt
requirements.txt指的是將專案所需要用到的工具和版本全部列在txt檔裡面，要用的時候可以直接以txt檔的形式使用conda匯入到環境裡面。  

我覺得會有兩種情境下可能拿到requirements.txt：

##### A. 現在很多Github上的專案，做的比較用心(甚麼意思，其他人也很用心 :angry:)的作者會幫你打包好他在Run這份Project時所用到的工具包和版本，可以確保其他人拿了這份code也能順利跑起來！！飛起來！！而且有一樣的結果~  

##### B. 如果是自己建立的專案，那代表你之前一定也有在過程中建立起來的虛擬環境，那個虛擬環境是可以成功執行這個專案的，那就去把那個虛擬環境裡的package list給export出來！
附上打包的指令~  

:bulb: **小提醒**：如果是用conda打包，那就要用conda匯入，如果試用pip打包，就要用pip匯入！他們彼此之間打包內容形式會有點點不一樣~~~

雖然我不是用pip，但還是附上freeze用法XD :

如果手上都有requirement.txt，那就打開我們剛剛建好的虛擬環境，把這些工具都匯入進去裝起來，開始裝潢這間空屋、放家具家電、裝飾品等等XD讓人走進去就可以躺在沙發上吹冷氣了ㄛ:laughing:  

*我這裡突然發現很奇怪的東西，用powershell打開路徑前面都沒有我當前的環境名稱，好奇怪，沒關C，我改成CMD(直接在VScode裡切換~)*   

![1717136543919](https://hackmd.io/_uploads/r15ahkDER.jpg)  



打開虛擬環境指令：


成功進入虛擬環境會看到路徑前面多了環境名稱，我們要在這個環境中匯入我們的工具包們
:star-struck:

如果你是用pip打包，請用pip安裝：  

有了requirements.txt，搭環境就是一件分分鐘的事，可以先去喝咖啡、聊聊天再回來看安裝好了沒 :wine_glass: :coffee: :cake:

出現done就是成功嚕~

這樣環境就都設置好了，可以開始執行程式了阿~~~~~~ :face_with_cowboy_hat:

Finally!!!!!!! :handshake::handshake::handshake:

### 5. 執行python!!!!

Done!