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