高效的在pycharm編寫flask程序

前言

本文所選用的環境是pycharm + pipenv + flask

其中Pipenv是基於pip的Python包管理工具， 它和pip的用法非常相似， 可以看作pip的加強版， 它的出現解決了舊的pip+virtualenv+requirements.txt的工作方式的弊端。 具體來說， 它是pip、 Pipfile和Virtualenv的結合體， 它讓包安裝、 包依賴管理和虛擬環境管理更加方便， 使用它可實現高效的Python項目開發工作流。

pipenv準備

pipenv 安裝

pip install pipenv

如果你不想全局安裝， 可以添加–user選項執行用戶安裝（即pip install--user pipenv） ， 並手動將用戶基礎二進制目錄添加到PATH環境變量中

創建虛擬環境

在Python中， 虛擬環境（virtual enviroment） 就是隔離的Python解釋器環境。 通過創建虛擬環境， 你可以擁有一個獨立的Python解釋器環境。 這樣做的好處是可以爲每一個項目創建獨立的Python解釋器環境，因爲不同的項目常常會依賴不同版本的庫或Python版本。
使用虛擬環境可以保持全局Python解釋器環境的乾淨， 避免包和版本的混亂， 並且可以方便地區分和記錄每個項目的依賴， 以便在新環境下復現依賴環境。虛擬環境通常使用Virtualenv來創建， 但是爲了更方便地管理虛擬環境和依賴包， 我們將會使用集成了Virtualenv的Pipenv。 確保我們當前工作目錄在項目的根目錄下，然後使用如下代碼創建虛擬環境：

pipenv install 

這會爲當前項目創建一個文件夾， 其中包含隔離的Python解釋器環境， 並且安裝pip、 wheel、 setuptools等基本的包。

默認情況下， Pipenv會統一管理所有虛擬環境。 在Windows系統中， 虛擬環境文件夾會在C： \Users\Administrator.virtualenvs\目錄下創建， 而Linux或macOS會在~/.local/share/virtualenvs/目錄下創建。 如果你想在項目目錄內創建虛擬環境文件夾， 可以設置環境變量PIPENV_VENV_IN_PROJECT， 這時名爲.venv的虛擬環境文件夾將在項目根目錄被創建。

虛擬環境文件夾的目錄名稱的形式爲“當前項目目錄名+一串隨機字符”， 比如hiflask-5Pa0ZfZw。

---

你可以通過–three和–two選項來聲明虛擬環境中使用的Python版本（分別對應Python3和Python2） ， 或是使用–python選項指定具體的版本號。 同時要確保對應版本的Python已經安裝在電腦中。

激活虛擬環境

顯式激活虛擬環境

pipenv shell

當執行該命令時候pipenv會啓動一個激活虛擬環境的子shell

隱式激活虛擬環境

這個命令允許你不顯式激活虛擬環境即可在當前項目的虛擬環境中執行命令:

pipenv run python hello.py

管理依賴

一個程序通常會使用很多的Python包， 即依賴（dependency） 。 而 程序不僅僅會在一臺電腦上運行， 程序部署上線時需要安裝到遠程服務 器上， 而你也許會把它分享給朋友。 如果你打算開源的話， 就可能會有 更多的人需要在他們的電腦上運行。 爲了能順利運行程序， 他們不得不 記下所有依賴包， 然後使用pip或Pipenv安裝， 這些重複無用的工作當然 應該避免。 在以前我們通常使用pip搭配一個requirements.txt文件來記錄 依賴。 但requirements.txt需要手動維護， 在使用上不夠靈活。 Pipfile的出 現就是爲了替代難於管理的requirements.txt。

在創建虛擬環境時， 如果項目根目錄下沒有Pipfile文件， pipenv install命令還會在項目文件夾根目錄下創建Pipfile和Pipfile.lock文件， 前 者用來記錄項目依賴包列表， 而後者記錄了固定版本的詳細依賴包列 表。 當我們使用Pipenv安裝/刪除/更新依賴包時， Pipfile以及Pipfile.lock 會自動更新。

當需要在一個新的環境運行程序時， 只需要執行pipenv install命 令。 Pipenv就會創建一個新的虛擬環境， 然後自動從Pipfile中讀取依賴 並安裝到新創建的虛擬環境中。

Flask 安裝

pipenv install flask

pycharm 搭建Flask集成開發環境

關於如何安裝pycharm在這裏不再詳細介紹，此處重點介紹如何利用虛擬環境來搭建Flask集成開發環境

設置python解釋器

在創建了項目之後，爲了使用我們虛擬環境中的python解釋器，需要進行相應的設置：
我們需要手動使用 pipenv命令安裝依賴， 同時還需要爲項目設置正確的Python解釋器。

1. 單擊菜單欄中的File→Settings打開設置
2. 然後單擊Project： mycode Project Interpreter選項打開項目Python解釋器設置窗口， 如下圖所示。
   
3. 單擊選擇字段右側的設置圖標， 然後單擊“Add Local Python Interpreter”， 在彈出的窗口選擇Virtualenv Enviroment→Existing enviroment， 在下拉框或是自定義窗口找到我們之前創建的虛擬環境中 的Python解釋器路徑， 如下圖所示。
   
   

正確設置以後， 重新創建一個Terminal會話， 你會發現命令行提示 符前出現了虛擬環境名稱， 說明虛擬環境已經激活。 以後每次打開項 目， PyCharm都會自動幫你激活虛擬環境， 並且把工作目錄定位到項目根目錄。 具體行爲你也可以在Settings→Tools→Terminal中設置。

使用pycharm運行服務器

首先， 在PyCharm中， 單擊菜單欄中的Run→Edit Configurations打 開運行配置窗口。 下圖中標出了在PyCharm中設置一個運行配置的具體 步驟序號。

1. 步驟1 單擊左側的“+”符號打開下拉列表。
2. 步驟2 新建一個Python類型的運行配置（如果你使用的是專業版， 則可以直接選擇Flask server） ， 並在右側的Name字段輸入一個合適的名稱， 比如“Run hello”。
3. 步驟3 勾選“Single instance only”。
4. 步驟4 將第一項配置字段通過下列選項選爲“Module Name”。
5. 步驟5 填入模塊名稱flask。
6. 步驟6 第二欄的“Parameters”填入要執行的命令run， 你也可以附加其他啓動選項。
7. 步驟7 在“Working directory”字段中選擇程序所在的目錄作爲工作
   目錄。
8. (可選)可以設置運行模式爲debug模式，這樣每次修改代碼之後，我們書寫的程序可以自動更新生效，避免每次都需要重新啓動服務

tips

我們可以單擊左上方的複製圖標複製一份配置， 然後稍加修改就可 以用於其他flask命令， 包括擴展提供的命令， 或是我們自定義的命令。