# PyCharm 安裝教學 (for Windows User)

[toc]

## 安裝pyCharm
1. 官方網站下載安裝包[Link](https://www.jetbrains.com/pycharm/download/#section=windows)
2. 選擇Professional版本(Community也可以)
3. 打開安裝檔
4. 出現UAC警告，點擊"Yes"
5. 點擊下一步
6. 安裝路徑使用預設路徑即可
7. "Update Path"選項必選，其餘皆可選可不選
8. 點選"Install"等候安裝完畢，等候安裝同時，可以先進行帳號註冊
9. 選擇"Rebot Now"，重新開機完成安裝

## 註冊帳號
1. 開啟網站[登入網站](https://account.jetbrains.com/login)，右下角填入email進行註冊帳號
2. 前往你剛剛輸入的email的信箱，會有一封帶有連結的信
3. 點選"Confirm your account"
4. 創建帳戶，設定密碼
5. 跳轉畫面後，可以利用學校帳號開通專業版
6. 網頁向下拉，點選 Apply now
7. 填寫基本資料，**學校信箱建議使用gapps，才收得到認證信件**
8. 點選(剛剛填寫的學校)email中連結
9. 回到[帳號管理頁面](https://account.jetbrains.com/)，點選上方"Your Account"
10. 點選右方選單中的"Linked email"
11. 填入你剛剛填的學校信箱，並到信箱中點選連結驗證
12. 再回到帳號管理頁面，如果有出現下圖，代表License匯入成功
13. 點選上圖紅色勾勾處按鈕進行啟用
14. 拉到最下方後，點選"Accept"
15. 完成！

## 首次使用pyCharm
:::warning
在每次開新專案時，都必須安裝對應的套件，因為在PyCharm裡，每個專案都有屬於他自己的虛擬環境。
:::
1. 打開pyCharm
2. 首次打開須同意使用者協議
3. Data Sharing可同意可不同意
4. 首次使用需登入帳號(點選"Login to JetBrain Account")，帳號請使用剛剛註冊的帳號
5. 如果出現防火牆警告，點選允許通過
6. 回到軟體，點選"Active"啟用，如果沒有抓到License，請檢查"註冊帳號"中的9~14步驟是否皆有確實完成
7. 點選"New Project"，建立新專案
8. 選擇 Pure Python 並設定好存放專案的路徑，按下 Create
9. 如果pyCharm偵測到電腦中沒有安裝python，此時便會自動安裝
11. UAC警告一樣點選"Yes"
12. 簡單介紹環境，中斷點**不是錯誤提示**，執行按鈕在右上角(綠色三角形)
13. 執行後，若下方視窗出現"Hi, PyCharm"則代表環境沒有問題！

## 安裝 fastAPI 框架
1. 下方視窗切換至Terminal
2. 輸入指令，等待安裝

    pip3 install fastapi

> 註：皆為小寫，且是用 pip3 指令下載
3. 出現"Successfully"則代表安裝成功
4. 繼續在終端機輸入以下指令，安裝 uvicorn 是搭配 fastAPI 在開發上的輔助工具

    pip3 install "uvicorn[standard]"

5. 測試，撰寫以下 python 程式碼

    from typing import Union

    from fastapi import FastAPI

    app = FastAPI()


    @app.get("/")
    def read_root():
        return {"Hello": "World"}


    @app.get("/items/{item_id}")
    def read_item(item_id: int, q: Union[str, None] = None):
        return {"item_id": item_id, "q": q}

6. 如果執行以上程式時，出現以下錯誤

	from fastapi import FastAPI 
	IndentationError: unexpected indent

請將滑鼠移到程式中fastapi的地方，會浮出提示視窗，點選"Install package fastapi"，並等待安裝完畢即可解決
7. 在終端機輸入以下指令

    uvicorn main:app --reload

8. 在終端機的結果當中點選網址，查看測試結果
9. 完成！
10.
> 過程中若遇到問題，可以參考[官方文檔](https://fastapi.tiangolo.com/)