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