【Python】グローバル変数を別ファイルで管理・利用する方法

Pythonのグローバル変数を別ファイルで管理することによって、複数のモジュール間でデータを共有することが可能です。この方法はプログラムの構造を整理しやすくなり、変数の一元管理を実現する際にに役立ちます。以下ではグローバル変数を別ファイルに定義して、他のファイルからインポートする最初に行う方法から説明します。

まず、グローバル変数を管理するためのファイルを作成し、必要な変数を定義することが最初のステップです。この専用ファイルを作ることによって、プログラム全体で使用する値を一箇所に集約でき、変更が必要な場合も修正箇所を特定できます。

他のファイルからグローバル変数を使用する場合は、インポート文を使用するだけです。Pythonのモジュールシステムを活用することによって、変数の値を変更した際にその変更がすべてのインポート先に反映されるという利点があります。

【サンプルコード】
counter = 0
app_name = "MyPythonApp"
settings = {
    "debug": True,
    "max_users": 100,
    "version": "1.0.0"
}

import globals

def increment_counter():
    globals.counter += 1
    print(f"カウンター: {globals.counter}")

def show_app_info():
    print(f"アプリ名: {globals.app_name}")
    print(f"設定情報: {globals.settings}")

increment_counter()
increment_counter()
show_app_info()

globals.app_name = "UpdatedApp"
show_app_info()

【実行結果】
カウンター: 1
カウンター: 2
アプリ名: MyPythonApp
設定情報: {'debug': True, 'max_users': 100, 'version': '1.0.0'}
アプリ名: UpdatedApp
設定情報: {'debug': True, 'max_users': 100, 'version': '1.0.0'}

【PR】『Python』を学べる企業・個人向けのプログラミングコース

• 「Python基礎・実践研修」

  

• 「オーダーメイドコース」

  

別ファイルに定義されたグローバル変数を更新する場合、インポートしたモジュール名を通じて直接アクセスしましょう。Pythonではモジュールもオブジェクトとして扱えるため、モジュールの属性として変数を参照し値を変更できます。

グローバル変数を更新するときは代入操作を行うだけですが、変数を定義した同一ファイル内で再代入する場合、globalキーワードを使う場合があります。外部からインポートした変数を更新するだけなら、globalキーワードは不要です。

また、複数のファイルから同じグローバル変数を更新する場合、更新のタイミングや順序に注意してください。あるモジュールで更新が行われると、その変更はインポート先で共有されます。

【サンプルコード】
database_url = "localhost:5432"
max_connections = 10
is_debug_mode = True

import config

def connect_to_db():
    print(f"データベース {config.database_url} に接続します")
    print(f"最大接続数: {config.max_connections}")

def change_db_settings(new_url, new_max):
    config.database_url = new_url
    config.max_connections = new_max
    print(f"設定を更新しました: {config.database_url}, {config.max_connections}")

import config

def log_status():
    if config.is_debug_mode:
        print("デバッグモードで実行中")
    else:
        print("通常モードで実行中")

def toggle_debug_mode():
    config.is_debug_mode = not config.is_debug_mode
    print(f"デバッグモードを {config.is_debug_mode} に変更しました")

import config
import database
import logger

database.connect_to_db()
logger.log_status()

database.change_db_settings("remote-server:5432", 20)
logger.toggle_debug_mode()

database.connect_to_db()
logger.log_status()

【実行結果】
データベース localhost:5432 に接続します
最大接続数: 10
デバッグモードで実行中
設定を更新しました: remote-server:5432, 20
デバッグモードを False に変更しました
データベース remote-server:5432 に接続します
最大接続数: 20
通常モードで実行中

別ファイルでグローバル変数を使用する場合、変数の初期化順序に注意してください。循環インポートが発生すると想定外の初期化状態になる可能性があるので、グローバル変数の定義を専用ファイルにまとめると循環インポートを避けやすくなります。

また、グローバル変数を多用しすぎてしまうと、コード全体が複雑になる恐れがあります。更新箇所が増えるほど動作が混乱しやすくなるため、必要最小限に留めてください。クラスを使った設定管理やシングルトンパターンなどの方法も検討してみた方が良いでしょう。

スレッドを併用する場合は、グローバル変数へのアクセス競合に気を配る必要があります。複数スレッドが同時に値を更新する場合は、ロック機構やThreadLocalなどを導入して衝突を回避してください。

※上記コンテンツの内容やソースコードはAIで確認・デバッグしておりますが、間違いやエラー、脆弱性などがある場合は、コメントよりご報告いただけますと幸いです。

ITやプログラミングに関するコラム

• 
  【Windows編】Pythonのバージョンをアップデートする方法
• 
  バージョン確認でPythonだけ表示される原因と対処法
• 
  【Python】リスト(list)の括弧を外す方法
• 
  【Python】時間計測をミリ秒単位で実装する方法

ITやプログラミングに関するニュース

• 
  Baiduが新世代AIモデル「ERNIE 4.5」と「ERNIE X1」発表！無料公開で次世代AI体験が加速
• 
  Google「Gemini 2.0 Flash」で画像生成と編集機能を追加！AIで画像編集がさらに自由に
• 
  汎用AIエージェント「Manus」登場！あなたの代わりに成果を出す新世代AIエージェント
• 
  Appleが新型iPad AirとMagic Keyboardを発表
• 
  AnthropicがClaude 3.7 Sonnetを発表！初のハイブリッド推論AIと拡張思考モードを搭載