Python?INI文件讀寫的詳細(xì)指南
更新時(shí)間：2025年07月17日 10:55:21 作者：Yant224
INI?文件是一種經(jīng)典的配置文件格式,常用于存儲(chǔ)程序的參數(shù)配置,以下是??INI?文件的結(jié)構(gòu)說明及??Python?讀寫?INI?文件的完整方法,包含代碼示例和注意事項(xiàng),需要的朋友可以參考下
一、INI文件基礎(chǔ)與Python環(huán)境
1. INI文件簡介
INI（Initialization）文件是一種經(jīng)典的配置文件格式：
- 基礎(chǔ)結(jié)構(gòu)：節(jié)(Section)、鍵(Key)、值(Value)
- 主要特點(diǎn)：
- 人類可讀的純文本格式
- 簡單直觀的分層結(jié)構(gòu)
- 廣泛的應(yīng)用支持（Windows系統(tǒng)、各類應(yīng)用）
- 適用場景：
- 應(yīng)用程序配置
- 系統(tǒng)參數(shù)設(shè)置
- 簡單的數(shù)據(jù)持久化
2. 典型INI文件結(jié)構(gòu)
; 這是注釋行 [Database] ; 節(jié)(Section) host = localhost ; 鍵(Key) = 值(Value) port = 5432 user = admin password = secret123 ; 包含特殊字符的值 [Logging] level = DEBUG file = /var/log/app.log max_size = 10 ; 單位：MB [Features] enabled = true modules = core, auth, api
3. Python標(biāo)準(zhǔn)庫支持
import configparser
configparser是Python標(biāo)準(zhǔn)庫的一部分，無需額外安裝，支持：
- Python 2.x和3.x全版本兼容
- 豐富的類型轉(zhuǎn)換
- 安全的插值(Interpolation)功能
- 靈活的讀寫選項(xiàng)
二、核心功能函數(shù)詳解
1. 文件讀取操作
ConfigParser.read(filenames, encoding=None)
功能：讀取并解析 INI 文件
??參數(shù)??：
filenames：文件路徑（字符串或列表）encoding：文件編碼（默認(rèn)為系統(tǒng)編碼）
??返回??：成功加載的文件列表
??特點(diǎn)??：- 支持多個(gè)文件輸入
- 自動(dòng)跳過不存在文件
案例：
import configparser
config = configparser.ConfigParser()
loaded_files = config.read(['app.ini', 'user.ini'], encoding='utf-8')
print(f"成功加載文件: {loaded_files}")
ConfigParser.get(section, option, *, raw=False, vars=None, fallback)
功能：獲取配置項(xiàng)的值
??參數(shù)??：
section：配置節(jié)名稱option：配置項(xiàng)名稱fallback：未找到時(shí)的默認(rèn)值raw：禁用插值處理vars：額外的變量字典
??返回??：配置項(xiàng)的字符串值
案例：
# 獲取數(shù)據(jù)庫端口（帶默認(rèn)值）
db_port = config.get('Database', 'port', fallback='5432')
print(f"數(shù)據(jù)庫端口: {db_port}")
# 禁用插值處理
log_file = config.get('Logging', 'file_path', raw=True)
2. 類型安全獲取
ConfigParser.getint(section, option, **kwargs)
功能：獲取整型配置值
??參數(shù)??：同 get()
??返回??：整數(shù)類型值
案例：
max_users = config.getint('System', 'max_users', fallback=100)
print(f"最大用戶數(shù): {max_users}")
ConfigParser.getfloat(section, option, **kwargs)
功能：獲取浮點(diǎn)型配置值
?參數(shù)??：同 get()
??返回??：浮點(diǎn)數(shù)類型值
案例：
mem_limit = config.getfloat('Resources', 'memory_limit', fallback=0.75)
print(f"內(nèi)存限制: {mem_limit}")
ConfigParser.getboolean(section, option, **kwargs)
功能：獲取布爾型配置值
??參數(shù)??：同 get()
??支持的值??：
'1', 'yes', 'true', 'on'→True'0', 'no', 'false', 'off'→False
案例：
debug_mode = config.getboolean('Debug', 'enabled', fallback=False)
print(f"調(diào)試模式: {debug_mode}")
3. 文件寫入操作
ConfigParser.write(fileobject, space_around_delimiters=True)
功能：將配置寫入文件
??參數(shù)??：
fileobject：文件對象space_around_delimiters：是否在等號(hào)周圍添加空格
??特點(diǎn)??：保持原有順序和注釋（但注釋會(huì)被丟棄）
案例：
# 更新配置并保存
config.set('Database', 'host', 'new.db.example.com')
with open('app.ini', 'w', encoding='utf-8') as f:
config.write(f, space_around_delimiters=False) # 緊湊格式
ConfigParser.add_section(section)
功能：添加新的配置節(jié)
??參數(shù)??：
section：節(jié)名稱
??錯(cuò)誤??：如果節(jié)已存在則拋出DuplicateSectionError
案例：
try:
config.add_section('Monitoring')
except configparser.DuplicateSectionError:
print("監(jiān)控節(jié)已存在")
config.set('Monitoring', 'interval', '60')
4. 實(shí)用工具函數(shù)
ConfigParser.has_section(section)
功能：檢查節(jié)是否存在
??返回??：布爾值
案例：
if not config.has_section('Backup'):
config.add_section('Backup')
ConfigParser.has_option(section, option)
功能：檢查選項(xiàng)是否存在
??返回??：布爾值
案例：
if config.has_option('Logging', 'verbosity'):
level = config.get('Logging', 'verbosity')
ConfigParser.items(section, raw=False, vars=None)
功能：獲取節(jié)的所有鍵值對
??返回??：(name, value) 元組列表
案例：
print("數(shù)據(jù)庫配置:")
for key, value in config.items('Database'):
print(f" {key} = {value}")
三、高級特性與配置處理
1. 插值（值引用）處理
ExtendedInterpolation()
功能：支持跨節(jié)的值引用?
語法??：${section:option} 或 $option（當(dāng)前節(jié)）
案例：
config = configparser.ConfigParser(interpolation=configparser.ExtendedInterpolation())
config['DEFAULT'] = {'app_root': '/opt/myapp'}
config['Database'] = {
'data_dir': '/var/data',
'backup_dir': '${app_root}/backup' # 引用默認(rèn)值
}
config['Logging'] = {
'log_dir': '${Database:data_dir}/logs', # 跨節(jié)引用
'file': '${log_dir}/app.log' # 當(dāng)前節(jié)引用
}
# 驗(yàn)證引用
print(config['Logging']['file']) # 輸出: /var/data/logs/app.log
2. DEFAULT 特殊節(jié)
全局默認(rèn)值機(jī)制
功能：
- 所有節(jié)繼承 DEFAULT 的鍵值
- 節(jié)內(nèi)同名鍵值覆蓋 DEFAULT
案例：
[DEFAULT] timeout = 30 retries = 3 [Database] host = localhost timeout = 60 # 覆蓋默認(rèn)值 [API] ; 繼承默認(rèn)超時(shí)30和重試3 endpoint = /api/v1
# 驗(yàn)證繼承 print(config['API']['timeout']) # 輸出: 30 print(config['Database']['retries']) # 輸出: 3
3. 多級配置管理
分層配置處理
功能：實(shí)現(xiàn)基礎(chǔ)配置 + 環(huán)境覆蓋配置
??方案??：創(chuàng)建配置管理器類
class LayeredConfig:
def __init__(self):
self.base = configparser.ConfigParser()
self.override = configparser.ConfigParser()
def load(self, base_file, override_file=None):
self.base.read(base_file, encoding='utf-8')
if override_file:
self.override.read(override_file, encoding='utf-8')
def get(self, section, option, default=None):
# 1. 檢查覆蓋配置
if self.override.has_option(section, option):
return self.override.get(section, option)
# 2. 檢查基礎(chǔ)配置
if self.base.has_option(section, option):
return self.base.get(section, option)
# 3. 返回默認(rèn)值
return default
# 使用示例
config = LayeredConfig()
config.load('base.ini', 'production.ini')
db_host = config.get('Database', 'host', 'localhost')
三、企業(yè)級最佳實(shí)踐
1. 配置驗(yàn)證模式
from schema import Schema, And, Use
CONFIG_SCHEMA = Schema({
'Database': {
'host': And(str, len),
'port': And(Use(int), lambda p: 1024 < p < 65535),
'user': str,
'password': str
},
'Logging': {
'level': Or('DEBUG', 'INFO', 'WARNING', 'ERROR'),
'file': str
}
})
def validate_config(config):
"""驗(yàn)證配置是否符合預(yù)期模式"""
# 轉(zhuǎn)換為普通字典
config_dict = {}
for section in config.sections():
config_dict[section] = dict(config.items(section))
# 驗(yàn)證
return CONFIG_SCHEMA.validate(config_dict)
# 使用
config = configparser.ConfigParser()
config.read('app.ini')
try:
validate_config(config)
print("配置驗(yàn)證通過")
except Exception as e:
print(f"配置錯(cuò)誤: {e}")
2. 安全加密存儲(chǔ)
from cryptography.fernet import Fernet
class SecureConfig:
def __init__(self, key_file='secret.key'):
self.key = self._load_key(key_file)
self.cipher_suite = Fernet(self.key)
def _load_key(self, path):
"""加載或生成密鑰"""
if os.path.exists(path):
with open(path, 'rb') as f:
return f.read()
else:
key = Fernet.generate_key()
with open(path, 'wb') as f:
f.write(key)
return key
def save_encrypted(self, config, filepath):
"""加密保存配置"""
with StringIO() as buffer:
config.write(buffer)
encrypted = self.cipher_suite.encrypt(buffer.getvalue().encode())
with open(filepath, 'wb') as f:
f.write(encrypted)
def load_encrypted(self, filepath):
"""加載并解密配置"""
with open(filepath, 'rb') as f:
encrypted = f.read()
decrypted = self.cipher_suite.decrypt(encrypted).decode()
config = configparser.ConfigParser()
config.read_string(decrypted)
return config
# 使用示例
secure = SecureConfig()
config = configparser.ConfigParser()
config['Database'] = {'password': 'super_secret'}
secure.save_encrypted(config, 'config.enc')
decrypted_config = secure.load_encrypted('config.enc')
3. 熱重載配置
import os
import time
import threading
class HotReloadConfig:
def __init__(self, filepath):
self.filepath = filepath
self.config = configparser.ConfigParser()
self.last_mtime = 0
self._lock = threading.Lock()
self.load()
# 啟動(dòng)監(jiān)控線程
self.watcher = threading.Thread(target=self._watch_changes, daemon=True)
self.watcher.start()
def load(self):
"""加載配置"""
with self._lock:
self.config.read(self.filepath)
self.last_mtime = os.path.getmtime(self.filepath)
def _watch_changes(self):
"""監(jiān)控文件變化"""
while True:
current_mtime = os.path.getmtime(self.filepath)
if current_mtime > self.last_mtime:
print("檢測到配置文件修改，重新加載")
self.load()
time.sleep(3) # 每3秒檢查一次
def get(self, section, option, fallback=None):
"""安全獲取值"""
with self._lock:
return self.config.get(section, option, fallback=fallback)
# 使用示例
if __name__ == '__main__':
config = HotReloadConfig('app.ini')
while True:
print(f"當(dāng)前調(diào)試模式: {config.get('Debug', 'enabled', 'false')}")
time.sleep(5)
四、實(shí)用案例解析
1. 應(yīng)用配置中心
class AppConfig:
_instance = None
def __new__(cls):
if not cls._instance:
cls._instance = super().__new__(cls)
cls._instance._init_config()
return cls._instance
def _init_config(self):
self.config = configparser.ConfigParser()
self.config.read('app.ini', encoding='utf-8')
# 預(yù)加載常用配置
self.debug_mode = self.config.getboolean('General', 'debug', fallback=False)
self.db_params = {
'host': self.config['Database']['host'],
'port': self.config.getint('Database', 'port'),
'user': self.config['Database']['user']
}
def get_feature_flag(self, feature):
"""獲取特性開關(guān)狀態(tài)"""
return self.config.getboolean('Features', feature, fallback=False)
def update_setting(self, section, key, value):
"""更新配置"""
if not self.config.has_section(section):
self.config.add_section(section)
self.config.set(section, key, value)
self._save()
def _save(self):
"""保存配置并重新加載"""
with open('app.ini', 'w', encoding='utf-8') as f:
self.config.write(f)
self._init_config() # 重新初始化
# 使用示例
config = AppConfig()
print("數(shù)據(jù)庫主機(jī):", config.db_params['host'])
# 動(dòng)態(tài)更新配置
config.update_setting('Database', 'host', 'new.host.example.com')
2. 多語言國際支持
; locales.ini [DEFAULT] language = en_US [en_US] greeting = Hello! farewell = Goodbye! [zh_CN] greeting = 你好！ farewell = 再見！ [fr_FR] greeting = Bonjour! farewell = Au revoir!
class I18nManager:
def __init__(self, filepath='locales.ini'):
self.config = configparser.ConfigParser()
self.config.read(filepath, encoding='utf-8')
# 獲取可用語言列表
self.languages = [s for s in self.config.sections() if s != 'DEFAULT']
# 設(shè)置當(dāng)前語言
self.current_lang = self.config.get('DEFAULT', 'language')
def set_language(self, lang_code):
"""設(shè)置當(dāng)前語言"""
if lang_code in self.languages:
self.current_lang = lang_code
return True
return False
def translate(self, key, default=None):
"""翻譯文本"""
try:
return self.config.get(self.current_lang, key)
except configparser.NoOptionError:
# 嘗試使用默認(rèn)語言
try:
return self.config.get('en_US', key)
except configparser.NoOptionError:
return default
# 使用示例
i18n = I18nManager()
print(i18n.translate('greeting')) # Hello!
i18n.set_language('zh_CN')
print(i18n.translate('greeting')) # 你好！
3. 跨平臺(tái)路徑處理
import os
from pathlib import Path
def resolve_path(config, section, key, default=None):
"""解析配置中的路徑并標(biāo)準(zhǔn)化"""
raw_path = config.get(section, key, fallback=default)
if raw_path is None:
return None
# 展開用戶目錄
expanded = os.path.expanduser(raw_path)
# 跨平臺(tái)路徑處理
path = Path(expanded)
# 處理環(huán)境變量
if '$' in expanded:
path = Path(os.path.expandvars(expanded))
return path.resolve()
# 使用示例
config = configparser.ConfigParser()
config.read('app.ini')
log_file = resolve_path(config, 'Logging', 'file', '/var/log/app.log')
data_dir = resolve_path(config, 'Database', 'data_dir', '~/app_data')
print(f"日志文件位置: {log_file}")
print(f"數(shù)據(jù)目錄: {data_dir}")
五、總結(jié)：核心方法速查表
1. 文件操作
| 方法 | 描述 | 參數(shù) | 返回 |
|---|---|---|---|
| read(filenames) | 讀取INI文件 | 文件路徑/列表 | 成功加載的文件列表 |
| write(fileobject) | 寫入配置 | 文件對象 | None |
| read_file(f) | Python 3.2+ 替代方法 | 文件對象 | None |
| read_dict(dictionary) | 從字典讀取配置 | 字典對象 | None |
2. 配置訪問
| 方法 | 描述 | 參數(shù) | 返回 |
|---|---|---|---|
| sections() | 獲取所有節(jié) | 無 | 節(jié)列表 |
| options(section) | 獲取節(jié)所有鍵 | 節(jié)名稱 | 鍵列表 |
| get(section, option) | 獲取配置值 | 節(jié), 鍵 | 字符串 |
| items(section) | 獲取所有鍵值對 | 節(jié)名稱 | (鍵,值)元組列表 |
3. 類型安全訪問
| 方法 | 描述 | 返回類型 |
|---|---|---|
| getint() | 獲取整數(shù)值 | int |
| getfloat() | 獲取浮點(diǎn)值 | float |
| getboolean() | 獲取布爾值 | bool |
4. 配置修改
| 方法 | 描述 | 錯(cuò)誤 |
|---|---|---|
| add_section(section) | 添加新節(jié) | DuplicateSectionError |
| remove_section(section) | 刪除節(jié) | NoSectionError |
| set(section, option, value) | 設(shè)置配置值 | NoSectionError |
| remove_option(section, option) | 刪除配置項(xiàng) | NoSectionError |
最佳實(shí)踐總結(jié)：
- 使用安全訪問：總是使用 get() 方法并提供 fallback 值
- 優(yōu)先類型方法：使用 getint(), getboolean() 等進(jìn)行類型轉(zhuǎn)換
- 規(guī)范文件格式：保持統(tǒng)一縮進(jìn)和空格風(fēng)格
- 分層配置管理：使用 DEFAULT 節(jié)提供全局默認(rèn)值
- 配置文件加密：生產(chǎn)環(huán)境敏感配置應(yīng)該加密存儲(chǔ)
- 配置版本控制：INI 文件納入版本控制系統(tǒng)管理
- 環(huán)境隔離：不同環(huán)境使用不同配置文件
通過掌握這些 INI 文件處理技術(shù)，您將能夠構(gòu)建高效可靠的配置管理系統(tǒng)，滿足從簡單應(yīng)用到企業(yè)級系統(tǒng)的各種需求。
以上就是Python INI文件讀寫的詳細(xì)指南的詳細(xì)內(nèi)容，更多關(guān)于Python INI文件讀寫的資料請關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
使用Python和python-pptx構(gòu)建Markdown到PowerPoint轉(zhuǎn)換器
在這篇博客中,我們將深入分析一個(gè)使用 Python 開發(fā)的應(yīng)用程序,該程序可以將 Markdown 文件轉(zhuǎn)換為 PowerPoint 演示文稿,我們將探討代碼結(jié)構(gòu)、功能和關(guān)鍵組件,并解決一個(gè)特定的 bug,需要的朋友可以參考下2025-03-03
Python安裝本地.whl文件的流程及注意事項(xiàng)
在Python的生態(tài)環(huán)境中.whl文件是一種預(yù)編譯的二進(jìn)制包,用于分發(fā)和安裝Python庫,這篇文章主要給大家介紹了關(guān)于Python安裝本地.whl文件的流程及注意事項(xiàng),文中講解了下載文件、安裝pip、使用pip安裝whl文件、驗(yàn)證安裝以及注意事項(xiàng),需要的朋友可以參考下2024-11-11
【python】matplotlib動(dòng)態(tài)顯示詳解
這篇文章主要介紹了matplotlib動(dòng)態(tài)顯示，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2019-04-04
如何將DataFrame數(shù)據(jù)寫入csv文件及讀取
在Python中進(jìn)行數(shù)據(jù)處理時(shí),經(jīng)常會(huì)用到CSV文件的讀寫操作,當(dāng)需要將list數(shù)據(jù)保存到CSV文件時(shí),可以使用內(nèi)置的csv模塊,若data是一個(gè)list,saveData函數(shù)能夠?qū)ist中每個(gè)元素存儲(chǔ)在CSV文件的一行,但需要注意的是,默認(rèn)情況下讀取出的CSV數(shù)據(jù)類型為str2024-09-09
python由已知數(shù)組快速生成新數(shù)組的方法
這篇文章主要介紹了python由已知數(shù)組快速生成新數(shù)組的方法,文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2020-04-04
正則表達(dá)式本身是一種小型的、高度專業(yè)化的編程語言，下面這篇文章主要給大家介紹了關(guān)于python利用正則表達(dá)式實(shí)現(xiàn)搜索單詞的相關(guān)資料，文中給出了詳細(xì)的示例代碼，需要的朋友可以參考借鑒，下面來一起看看吧。2017-09-09
這篇文章主要來和大家分享一個(gè)Python提高運(yùn)維效率的腳本，文中的示例代碼講解詳細(xì)，具有一定的學(xué)習(xí)價(jià)值，感興趣的小伙伴可以參考下2023-05-05
本文給大家介紹的是python基于XPath實(shí)現(xiàn)多線程爬蟲的實(shí)例以及XPath的介紹安裝和簡單用法，非常的細(xì)致，有需要的小伙伴可以參考下2016-09-09
這篇文章主要介紹了keras中的History對象用法，具有很好的參考價(jià)值，希望對大家有所幫助。一起跟隨小編過來看看吧2020-06-06
當(dāng)我們處理數(shù)據(jù)時(shí),有時(shí)候需要?jiǎng)?chuàng)建多個(gè)列表以存儲(chǔ)不同類型或不同條件下的數(shù)據(jù),在Python中,我們可以利用循環(huán)來快速、高效地創(chuàng)建這些列表,本文將介紹如何使用循環(huán)在Python中創(chuàng)建多個(gè)列表,需要的可以參考下2024-04-04