# Thonny 使用備忘
By 蓉爸 RungBa
Created: 2023-08-26
Revised: 2025-06-12

---
:::success
**For Thonny 4.x 版**

- **官網**：https://thonny.org/

- **GitHub**: https://github.com/thonny/thonny/releases
:::

**Ref:**
- **[Getting Started with Thonny MicroPython (Python) IDE for ESP32 and ESP8266](https://randomnerdtutorials.com/getting-started-thonny-micropython-python-ide-esp32-esp8266/)**


- **[ ()]()**

---
## 一、For 本地端 Python

### 1. 切換工作目錄


----
### 2. 建立與啟用 Python 虛擬環境
**For MS Win**

## 建立虛擬環境，例如建立以 clienv 為名的虛擬環境
python -m venv clienv

## 啟動 clienv 虛擬環境
clienv\Scripts\activate

## 更新虛擬環境的 pip 套件
python -m pip install --upgrade pip

## 安裝所需要的套件範例
#pip install [xxx] [yyy]

**For Linux**

## 建立虛擬環境，例如建立以 clienv 為名的虛擬環境
python3 -m venv clienv

## 啟動 clienv 虛擬環境
./clienv/Scripts/activate

## 更新虛擬環境的 pip 套件
python3 -m pip install --upgrade pip

## 安裝所需要的套件範例
#pip install [xxx] [yyy]

----
### 3. 在虛擬環境安裝專案所需的套件
- **3-1. 啟用這個專案的 Python 虛擬環境，如下圖：**

- **3-2. 開啟系統終端機**

- **3-3. 在系統終端機內，安裝專案所需套件**
**For MS Win**

  ## 安裝專案所需的套件
  pip install [套件1] ... [套件n]

**For Linux**

  ## 安裝專案所需的套件
  pip3 install [套件1] ... [套件n]

----
### 4. 結束 Python 虛擬環境
- **4-1. 必須利用下方的「1. 切換直譯器」的方式來切換回「本地端的 Python 3」來做！！！**

---
## 二、設定 ESP32 MicroPython

### 1. 切換直譯器
- **1-1. 點選「執行」/「設定直譯器」**

- **1-2. 點選「MicroPython (ESP32)」如下圖：**

### 2. 切換 COM 連接埠
- **2-1. 滑鼠一到右下角，點一下就會出現選項，如下圖：**

- **2-2. 點選「MicroPython (ESP32)．USB Serial @ COM6」如下圖：**

- **2-3. 當看到「互動環境」出現類似如下圖的訊息，就對了！**

---
## 三、 如果刷 ESP32 的 Firmware
### 1. 刷 MicroPython 官方 Firmware

----
### 2. 刷第三方 Firmware

---
## 四、RPi OS/Linux 如何升級 Thonny IDE 版本
- **直接在系統的 Terminal 下，執行以下指令**

## 更新 Thonny 套件
pip3 install --upgrade thonny