用 Python 一鍵搜尋並取代 .ini 設定檔中的字串

螃蟹_crab

發佈於Python[基礎][應用][相關]

更新於 2025/04/15發佈於 2025/04/15閱讀時間約 7 分鐘

在軟體開發或部署過程中，我們經常需要對多個 .ini 設定檔進行批次修改，例如將某個舊的參數名稱或路徑名稱，替換成新的命名。

這就像記事本的「全部取代」功能，但你不需要一個個打開檔案慢慢點——你可以用 Python 自動完成這些事！

本文將介紹一個 Python 函式：search_and_replace_in_ini，它可以幫你：

✅ 遞迴搜尋某個資料夾內所有 .ini 檔案

✅ 找出含有指定字串的檔案

✅ 將該字串替換為新字串

✅ 自動儲存修改結果

🧠 程式邏輯說明

這段程式的核心流程如下：

python
複製編輯def search_and_replace_in_ini(self, folder_path, old_name, new_name):
    for root, _, files in os.walk(folder_path):              # 遞迴掃描資料夾
        for file in files:
            if file.endswith('.ini'):                        # 只針對 .ini 檔案
                if file in self.modify_ini_path_name:        # 限定特定檔案名稱才修改
                    file_path = os.path.join(root, file)     # 組成完整檔案路徑
                    with open(file_path, 'r', encoding='utf-8') as f:
                        lines = f.readlines()                # 一行一行讀進來

                    modified = False
                    for i, line in enumerate(lines):
                        if old_name in line:                 # 找到要換的字串
                            lines[i] = line.replace(old_name, new_name)  # 取代
                            modified = True

                    if modified:                             # 有修改才重新寫入
                        with open(file_path, 'w', encoding='utf-8') as f:
                            f.writelines(lines)

🧰 使用方式教學

✅ 1. 參數介紹

folder_path要搜尋的資料夾路徑（可遞迴）

old_name要被取代的舊字串

new_name要替換的新字串

self.modify_ini_path_name

限定要修改的 .ini 檔案清單（此屬性需先設定）

🛠️ 2. 初始化與使用範例

你可以這樣建一個簡單的類別來使用它：

import os

class IniEditor:
    def __init__(self):
        # 這裡你可以放要處理的特定 ini 檔名
        self.modify_ini_path_name = ['config.ini', 'app.ini']

    def search_and_replace_in_ini(self, folder_path, old_name, new_name):
        for root, _, files in os.walk(folder_path):
            for file in files:
                if file.endswith('.ini'):
                    if file in self.modify_ini_path_name:
                        file_path = os.path.join(root, file)
                        with open(file_path, 'r', encoding='utf-8') as f:
                            lines = f.readlines()
                        
                        modified = False
                        for i, line in enumerate(lines):
                            if old_name in line:
                                lines[i] = line.replace(old_name, new_name)
                                modified = True
                        if modified:
                            with open(file_path, 'w', encoding='utf-8') as f:
                                f.writelines(lines)

# 範例執行
editor = IniEditor()
editor.search_and_replace_in_ini('./configs', 'OLD_NAME', 'NEW_NAME')