深入理解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)文章
plotly的Python軟件包是一個開源的代碼庫，是一款擅長交互的Python繪圖庫。本文就來用plotly繪制正二十面體，需要的可以參考一下2023-02-02
這篇文章主要介紹了Python如何對齊字符串，文中講解非常細(xì)致，代碼幫助大家更好的理解和學(xué)習(xí)，感興趣的朋友可以了解下2020-07-07
python實現(xiàn)超市商品銷售管理系統(tǒng)
這篇文章主要為大家詳細(xì)介紹了python實現(xiàn)超市商品銷售管理系統(tǒng)，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價值，感興趣的小伙伴們可以參考一下2019-10-10
python機器學(xué)習(xí)實戰(zhàn)之最近鄰kNN分類器
這篇文章主要介紹了python機器學(xué)習(xí)實戰(zhàn)之最近鄰kNN分類器，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價值，感興趣的小伙伴們可以參考一下2017-12-12
我喜歡你！這篇文章主要為大家詳細(xì)介紹了抖音表白程序python版的實現(xiàn)方法，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價值，感興趣的小伙伴們可以參考一下2019-04-04
這篇文章主要介紹了Django框架 查詢Extra功能實現(xiàn)解析,文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友可以參考下2019-09-09
本篇文章主要介紹了Django 前后臺的數(shù)據(jù)傳遞的方法，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2017-08-08
這篇文章主要介紹了Python實現(xiàn)的簡單讀寫csv文件操作,結(jié)合實例形式分析了Python使用csv模塊針對csv文件進行讀寫操作的相關(guān)實現(xiàn)技巧與注意事項,需要的朋友可以參考下2018-07-07
這篇文章主要介紹了解決同一目錄下python import報錯問題,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2023-12-12
大家好，本篇文章主要講的是python日志模塊loguru詳解，感興趣的同學(xué)趕快來看一看吧，對你有幫助的話記得收藏一下2022-02-02