第一個專案

8.1 解構 IDE 界面

好了，我們創建了一個新專案。讓我們來看看這裡有什麼吧。

1. 專案的資料夾和文件樹：

這裡顯示了我們專案文件夾的內容 — pythonProject。

2. 當前打開的文件：

這是 — 文件 main.py 的內容，代碼語法已高亮。

3. 頂部 — 主菜單：

右上角有幾個有用的按鈕：

• 「綠色三角形」 — 啟動專案的按鈕。
• 「小蟲子」 — 開啟除錯模式的按鈕。
• 「放大鏡」 — 搜尋專案。
• 「齒輪」 — 設定。

4. 左邊你可以看到側邊菜單：

這兒有幾個有用的按鈕，特別是我們會感興趣的 按鈕 Terminal。

5. 狀態欄：

在狀態欄的左邊顯示當前打開文件的路徑。右邊 — 是文件的 編碼：CRLF, UTF-8。

最右邊顯示當前的 Python 版本 — Python 3.12.x，這是我們 專案將運行的版本。當你電腦上安裝了多個不同版本的 Python 並且有些 專案需要其他版本時，看看這裡會很有用。

8.2 專案分析

一個普通的專案由顯示在左側面板中的檔案組成。這些檔案可以大致分為 4 個部分。

Python 程式碼檔案。這類檔案具有 .py 副檔名，PyCharm 會用藍黃相間的圖示標記它們。目前我們的專案中只有一個這樣的檔案 — main.py

靜態檔案。 這是指包含資料但不包含程式碼的檔案。這可以是文字檔案、圖片、媒體檔案等等。目前我們的專案中沒有這些檔案。

Python 虛擬環境。在名為 .venv（Virtual Environment 的縮寫）的資料夾中包含 Python 檔案以及一些服務工具程式。套件管理器 pip 也會將您想要使用的第三方函式庫下載到這裡。

第三方函式庫 (External libraries)。目前我們的專案中沒有這些，但當您下載它們時，PyCharm 一定會在這裡顯示它們。

8.3 虛擬環境 .venv

讓我們稍微詳細地談談虛擬環境。.venv 是 Python 中的一個模組，提供了為 Python 專案建立各種輕量級和隔離虛擬環境的能力。這是一個允許管理專案依賴關係並將其與系統函式庫隔離的工具。想像一下，這是您專案的一個隔離房間，它可以在這裡存放自己的私人玩具和工具，而不打擾家裡的其他住戶。

從技術上講，它的運作很簡單：在專案資料夾內建立 Python 直譯器的副本和一個單獨的函式庫存放處。這保證了如果您為一個專案安裝了某個特定版本的函式庫，它不會破壞另一個需要較舊版本的專案。使用虛擬環境是一種良好的習慣，可以避免無休止的版本衝突。

在 PyCharm 中管理環境

PyCharm 通常會自行處理並自動建立所有內容。但有時您可能會意外刪除了所需的資料夾，或者只是想從頭開始。能夠手動管理這些設定是一項有用的技能。

建立環境

在右下角顯示 Python 連接狀態。如果您在那裡看到類似 Python 3.XX 的字樣，表示安裝成功。開發環境看到了直譯器並準備好執行您的指令。

如果那裡寫著 No interpreter，請點擊該字樣。

1. 在出現的選單中選擇 Add New Interpreter，然後選擇 Add Local Interpreter。
2. 在左側的設定中選擇 Environment。在中間確保勾選了 Generate New。
3. 點擊 OK。編輯器將建立一個新的 .venv 資料夾並立即將專案切換到該資料夾。現在您擁有一個絕對乾淨的系統，沒有多餘的垃圾。

刪除舊的或多餘的

有時實驗會走進死胡同，刪除環境比嘗試修復它更容易。以下是如何做到這一點：

1. 再次點擊右下角的 Python 版本並選擇 Interpreter Settings 項目。
2. 在頂部尋找 Python Interpreter 欄位。展開清單並選擇 Show All 項目。
3. 您將看到 PyCharm 知道的所有環境的清單。選擇您想要刪除的環境，然後點擊清單上方選單中的 減號 按鈕。
4. 重要的一點：PyCharm 只是「忘記」了這個環境並停止使用它。要物理釋放磁碟空間，您需要透過一般的檔案總管進入專案資料夾並手動刪除 .venv 資料夾。

建立第二個環境

錯誤：「Already contains Python」

如果您進入新增直譯器選單並選擇 Generate new，PyCharm 可能會顯示紅色警告並鎖定 OK 按鈕。發生這種情況是因為編輯器習慣性地嘗試在同一個 .venv 資料夾中建立新環境，而該資料夾已經被您的第一個環境佔用。兩個不同的函式庫集合不能共存在一個資料夾中。

如何修復此問題

只需給新的「沙盒」一個唯一的名稱即可。以下是如何做到這一點：

1. 打開 Add Local Interpreter 選單，就像我們之前做的那樣。
2. 選擇 Generate new 項目。
3. 查看 Location 欄位。最有可能的是，那裡的路徑以標準名稱 \.venv 結尾。
4. 將游標放在行尾，只需在那裡添加任何數字即可。將路徑結尾更改為 \.venv_2 並按 Enter。
5. 紅色字樣將立即消失。點擊 OK。

現在您的專案中將物理存在兩個不同的設定資料夾，PyCharm 會自動切換到新版本。

如何在環境之間切換

在環境之間切換的能力是一項重要技能。但這裡有一個陷阱：PyCharm 並不總是自動記住您的舊環境。

經常發生這樣的情況：您建立了一個新環境，而第一個環境從選單中消失了，儘管 .venv 資料夾仍在專案中。在這種情況下，您只需告訴 PyCharm 在哪裡尋找舊的 Python。從 .venv_2 切換到 .venv 的範例：

1. 點擊角落的 Python 版本並選擇 Add New Interpreter -> Add Local Interpreter。
2. 在出現的視窗中，將點切換到 Select Existing 項目。
3. 在 Python Path 欄位中，點擊右側的資料夾圖示。
4. 現在您需要在舊資料夾 (.venv) 中找到 Python 啟動檔案。路徑為：您的專案 -> .venv -> Scripts（Windows）或 bin（macOS/Linux）。
5. 在此資料夾內選擇 python 檔案並點擊 OK。

現在舊環境將再次出現在設定中並變為活動狀態。即使 PyCharm「忘記」了您的設定，此方法也絕對有效。

8.4 使用終端

在 PyCharm 中，你可以直接使用操作系統的命令行。在 Linux 和 MacOS 中，命令行被稱為 Terminal，所以在 PyCharm 中它也被如此稱呼。不過這不是 PyCharm 的怪癖，而是程序員中的慣例。

要打開 Terminal 你需要點擊側邊菜單中的終端按鈕：

你應該會看到這樣的窗口：

在這個窗口中你可以輸入操作系統的命令。而我們 對其中的一個特別感興趣。

讓我們看看我們安裝的 Python 解釋器的當前版本。 為此你需要輸入：

        python --version

這是我得到的結果：

如果你也得到了 Python 3.12.x，那麼我們走在正確的道路上。