程式執行與除錯
================

JEditor 內建程式碼執行引擎，支援執行 Python 腳本、編譯式語言和任意 Shell 命令，
無需離開編輯器。

執行 Python 腳本
------------------

按下 **F5** 執行目前的 Python 檔案。JEditor 會：

1. 偵測 Python 直譯器（如有虛擬環境則自動使用）
2. 在背景程序中執行腳本
3. 即時串流輸出到結果面板
4. 以紅色顯示錯誤訊息，方便識別

**虛擬環境支援：**

JEditor 會自動偵測專案根目錄中的 ``venv`` 資料夾，並使用虛擬環境的 Python 直譯器執行，
確保套件解析正確。

您也可以從 **Python Env** 選單手動選擇 Python 直譯器。

除錯模式
---------

按下 **F9** 以除錯模式啟動目前的 Python 檔案：

- 整合 Python 除錯器（pdb）
- 執行期間檢視變數（詳見下方「變數檢視器」）
- 支援逐步除錯

停止執行
^^^^^^^^^

- **Shift+F5** — 停止所有正在執行的程序
- 也可從 **Run** 選單停止個別程序

執行其他語言
--------------

透過插件系統，JEditor 支援執行其他語言的檔案：

**直譯式語言**（直接執行）：

- **Go** — ``go run file.go``
- **Java** — ``java file.java``

**編譯式語言**（先編譯再執行）：

- **C** — ``gcc file.c -o file && ./file``
- **C++** — ``g++ file.cpp -o file && ./file``
- **Rust** — ``rustc file.rs -o file && ./file``

詳情請參閱 :doc:`plugins` 了解如何為新語言新增執行設定。

Shell 命令執行
----------------

JEditor 提供內建的 Shell 用於執行任意命令：

- 直接執行任何 Shell / 終端機命令
- 跨平台 Shell 支援：``cmd``、``PowerShell``、``bash``、``sh``
- 從主控台元件的下拉選單選擇偏好的 Shell
- 即時串流輸出，結果以顏色區分
- 隨時可停止正在執行的 Shell 程序

輸出顯示
---------

編輯器底部的結果面板顯示執行輸出：

- **正常輸出** — 以設定的正常顏色顯示
- **錯誤輸出** — 以紅色顯示，方便識別
- **系統訊息** — 以特定顏色顯示
- 輸出行數上限可設定（預設：200,000 行）以防止記憶體問題
- 可從 **Run** 選單或主控台的清除按鈕清除結果

變數檢視器
-----------

變數檢視器提供執行期間的變數除錯功能，以表格形式呈現：

.. list-table::
   :header-rows: 1
   :widths: 25 75

   * - 欄位
     - 說明
   * - 名稱
     - 變數名稱
   * - 型別
     - 變數的 Python 型別
   * - 值
     - 目前的值（可編輯）

功能特色：

- 腳本執行期間即時檢視變數
- 過濾內建變數（以 ``__`` 開頭的變數）
- 可編輯變數值，支援基於 AST 的型別轉換
- 動態更新命名空間
- 排序與搜尋功能