深入理解Python之.env
更新時間：2025年08月05日 09:02:15 作者：無風(fēng)聽海
.env是一個純文本文件,用于保存環(huán)境變量,本文就來介紹一下Python之.env環(huán)境變量配置的實現(xiàn),具有一定的參考價值,感興趣的可以了解一下
? 一、.env文件是什么？
.env 是一個純文本文件，用于保存環(huán)境變量（環(huán)境配置）。它最初被廣泛用于 Unix/Linux 系統(tǒng)，現(xiàn)在被各種語言（如 Python、Node.js、Go、Java）項目采納，成為現(xiàn)代開發(fā)中配置與代碼解耦的重要手段。
?? 1.1.env文件的功能
| 功能 | 說明 |
|---|---|
| 配置解耦 | 將數(shù)據(jù)庫地址、密鑰、路徑等配置從代碼中抽離 |
| 管理多環(huán)境 | 可以為不同環(huán)境（開發(fā)、測試、生產(chǎn)）使用不同的 .env 文件 |
| 跨平臺兼容 | .env 文件是純文本格式，可被廣泛識別 |
| 安全性增強 | 敏感信息如密碼、Token 可獨立管理，不暴露在代碼倉庫中 |
?? 1.2.env文件格式語法詳解
? 基本語法：
KEY=VALUE
? 完整語法示例：
# 字符串 APP_NAME=MyAwesomeApp # 布爾值（字符串表示） DEBUG=True # 數(shù)字（仍作為字符串處理） PORT=8080 # 空值 LOG_PATH= # 引號包裹的值（包含空格） WELCOME_MESSAGE="Hello, user!" # 注釋行 # This is a comment
?? 注意事項：
- 不要加空格：
KEY = VALUE是錯誤寫法。 - 所有值都是字符串（使用時需自行轉(zhuǎn)換）。
- 不支持嵌套結(jié)構(gòu)（不像 JSON / YAML）。
?? 1.3 使用場景
| 場景 | 示例配置 |
|---|---|
| 本地開發(fā)配置 | 調(diào)試模式開關(guān)、端口號 |
| 與數(shù)據(jù)庫/服務(wù)連接配置 | 數(shù)據(jù)庫主機、用戶名、密碼等 |
| Docker / CI / 云平臺部署 | 注入環(huán)境變量 |
| 應(yīng)用參數(shù)配置 | 日志路徑、語言、運行模式等 |
?? 二、在 Python 中使用.env
? 2.1 安裝依賴庫
使用 python-dotenv 來加載 .env 文件：
pip install python-dotenv
? 2.2 示例項目結(jié)構(gòu)
my_project/ ├── .env ├── .env.example ├── config.py └── main.py
?? 2.3.env示例
APP_NAME=MyService DEBUG=True PORT=8080 DATABASE_URL=postgresql://user:pass@localhost:5432/mydb
?? 2.4 Python 使用方式
??config.py
import os
from dotenv import load_dotenv
# 加載 .env 文件到系統(tǒng)環(huán)境變量中
load_dotenv()
# 從環(huán)境變量中讀取配置項
APP_NAME = os.getenv("APP_NAME", "DefaultApp")
DEBUG = os.getenv("DEBUG", "False") == "True"
PORT = int(os.getenv("PORT", 8000))
DATABASE_URL = os.getenv("DATABASE_URL")
??main.py
from config import APP_NAME, DEBUG, PORT, DATABASE_URL
def run():
print(f"Starting {APP_NAME} on port {PORT}")
print(f"Debug mode: {DEBUG}")
print(f"Database: {DATABASE_URL}")
if __name__ == "__main__":
run()
?? 三、.env的安全性機制詳解
.env 文件是明文文件，不加密，它的安全性來自你的使用方式，而不是文件自身。
? 安全措施建議：
| 做法 | 描述 |
|---|---|
| ? 不上傳 .env 到 Git 倉庫 | 將 .env 加入 .gitignore |
| ? 提交 .env.example | 用作參考模板，不包含任何敏感信息 |
| ? 設(shè)置文件權(quán)限 | 本地設(shè)置為 chmod 600 .env，僅本人可讀 |
| ? 在生產(chǎn)環(huán)境中使用系統(tǒng)環(huán)境變量 | 不在服務(wù)器存儲 .env，而是通過配置平臺環(huán)境變量 |
| ? 不在日志中輸出環(huán)境變量 | 防止無意間泄露機密信息 |
??.gitignore示例：
# 忽略本地配置 .env .env.* !*.env.example
??.env.example示例（無敏感值）：
APP_NAME= DEBUG=False PORT=8000 DATABASE_URL=
?? 四、與其他配置文件類型的對比
| 配置文件類型 | 是否支持結(jié)構(gòu)化 | 可注釋 | 易讀性 | 編程無關(guān)性 | 配置復(fù)雜性 | 推薦用途 |
|---|---|---|---|---|---|---|
| .env | ?（僅字符串鍵值） | ? | ? | ? | 低 | 環(huán)境變量、輕量配置 |
| .json | ?（嚴(yán)格結(jié)構(gòu)） | ? | 中 | ? | 中 | 配置接口、靜態(tài)參數(shù) |
| .yaml / .yml | ?（高度結(jié)構(gòu)化） | ? | ? | ? | 高 | 配置服務(wù)、K8s、Docker |
| .ini | ?（簡單結(jié)構(gòu)） | ? | 中 | ? | 中 | 插件系統(tǒng)、應(yīng)用啟動配置 |
| .py（Python 配置模塊） | ? | ? | ? | ?（依賴解釋器） | 任意復(fù)雜 | 高級配置邏輯（如 FastAPI Settings） |
?.env的適用性總結(jié)
| 優(yōu)點 | 缺點 |
|---|---|
| ? 語法簡單，學(xué)習(xí)成本低 | ? 不支持復(fù)雜結(jié)構(gòu)（如嵌套字典） |
| ? 跨語言、跨平臺兼容性好 | ? 所有值為字符串，需要手動轉(zhuǎn)換類型 |
| ? 與系統(tǒng)環(huán)境變量兼容 | ? 不能直接包含列表或嵌套結(jié)構(gòu) |
| ? 非開發(fā)人員也能理解和編輯 | ? 不適用于需要大量配置的復(fù)雜場景 |
? 五、總結(jié)
| 項目 | 內(nèi)容 |
|---|---|
| .env 是 | 一個文本文件，保存鍵值對形式的環(huán)境變量 |
| 用途 | 用于安全、統(tǒng)一地管理項目配置 |
| Python 中使用 | 借助 python-dotenv，結(jié)合 os.getenv() |
| 安全性實踐 | 不上傳、設(shè)權(quán)限、用 .env.example 提供模板 |
| 對比其他配置格式 | .env 簡單輕量，適合小型/中型配置；復(fù)雜配置建議用 YAML/JSON |
到此這篇關(guān)于深入理解Python之.env的文章就介紹到這了,更多相關(guān)Python .env內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
python實現(xiàn)遠(yuǎn)程通過網(wǎng)絡(luò)郵件控制計算機重啟或關(guān)機
這篇文章主要為大家詳細(xì)介紹了python實現(xiàn)遠(yuǎn)程通過網(wǎng)絡(luò)郵件控制計算機重啟或關(guān)機，具有一定的參考價值，感興趣的小伙伴們可以參考一下2018-02-02
PyTorch之torch.randn()如何創(chuàng)建正態(tài)分布隨機數(shù)
這篇文章主要介紹了PyTorch之torch.randn()如何創(chuàng)建正態(tài)分布隨機數(shù)問題，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2023-02-02
這篇文章主要介紹了Python線程詳解,本文詳細(xì)講解了線程方方面面的知識,如線程基礎(chǔ)知識線程狀態(tài)、線程同步（鎖）、線程通信（條件變量）等內(nèi)容,需要的朋友可以參考下2015-06-06
Pandas.concat連接DataFrame,Series的示例代碼
本文主要介紹了Pandas.concat連接DataFrame,Series的示例代碼，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2023-02-02
在Mac OS上部署Nginx和FastCGI以及Flask框架的教程
這篇文章主要介紹了在Mac OS上部署Nginx和FastCGI以及Flask框架的教程,Flask是Python下一個極簡的web開放框架,需要的朋友可以參考下2015-05-05
這篇文章主要介紹了OpenCV圖像處理中常用的幾個圖像幾何變換：裁剪、放大、縮小、平移、錯切、鏡像、旋轉(zhuǎn)、透視等。文中示例代碼非常詳細(xì)，需要的朋友可以參考一下2021-12-12
python利用thrift服務(wù)讀取hbase數(shù)據(jù)的方法
今天小編就為大家分享一篇python利用thrift服務(wù)讀取hbase數(shù)據(jù)的方法，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2018-12-12
Pycharm安裝報錯:Cannot detect a launch confi
本文主要介紹了Pycharm安裝報錯:Cannot detect a launch configuration解決辦法,具有一定的參考價值,感興趣的可以了解一下2025-03-03
os.path 模塊是系統(tǒng)路徑操作模塊，但實際的原理可以把它認(rèn)為是處理包含斜杠("/")和反斜杠("\")字符串的模塊，其中，斜杠("/")是 linux 系統(tǒng)下的路徑分隔符，和反斜杠("\")是 windows 系統(tǒng)下的路徑分隔符2022-08-08
Python函數(shù)式編程之面向過程面向?qū)ο蠹昂瘮?shù)式簡析
這一番我們要學(xué)習(xí)點有難度的了，因此將降低閱讀與理解難度，盡量采用大白話為你鋪墊，因為涉及的一些概念也是借鑒的其它編程語言的風(fēng)格，而且實際落地中存在部分爭議不過多學(xué)一點，總是沒有壞處的2021-09-09