0

0

如何在 Python 项目中全局共享并复用单个类实例?

花韻仙語

花韻仙語

发布时间:2026-01-07 21:37:00

|

180人浏览过

|

来源于php中文网

原创

如何在 Python 项目中全局共享并复用单个类实例?

通过模块级单例 + 多线程协同,可在同一进程内让多个逻辑模块(如 gui 和网络监听)安全共用同一个类实例,避免重复初始化导致的状态隔离问题。

在 Python 中,“跨文件共享同一个对象实例”这一需求看似简单,实则常因误解执行模型而失败。你当前的结构——分别运行 monitor.py 和 main.py 两个独立进程——本质上是两个完全隔离的 Python 解释器实例。即使它们都导入了 button.py,其中的 my_button = MyButtons() 也会被各自执行一次,生成两个互不相干的对象。这是进程隔离的底层机制决定的,与导入路径或模块缓存无关。

✅ 正确解法:将 GUI 主循环与业务逻辑(如 Socket 监听)合并至单个进程,并采用多线程协作模式。这样所有模块共享同一内存空间,button.py 中的 my_button 实例自然成为全局唯一对象。

✅ 推荐重构方案(单进程 + 双线程)

首先,修改 button.py,确保其设计支持线程安全(尤其注意 Tkinter 的 GUI 操作必须在主线程执行):

Favird No-Code Tools
Favird No-Code Tools

无代码工具的聚合器

下载
# frontend/modules/button.py
import math
from frontend.utilities.screen_info import screen_info
from frontend.env import BTN_SIZE, SUCCESS_COLOR, FAIL_COLOR, WARNING_COLOR, BTN_X_PADDING, BTN_Y_PADDING
from frontend.modules.master import master, Button
from backend.ip_list import ip_list

screen_width, screen_height = screen_info()


class MyButtons:
    def __init__(self):
        self.current_btn = None
        self.btns = []
        self.items = ip_list
        self.attach_all_buttons()

    def create_btn(self, item, k):
        btn = Button(
            master,
            text=item,
            bg=FAIL_COLOR,
            command=lambda: self.click_btn(k)
        )
        self.btns.append(btn)
        self.current_btn = btn

    def click_btn(self, id):
        # 注意:Tkinter 方法调用必须在主线程!
        if self.btns[id].cget('bg') == WARNING_COLOR:
            self.btns[id].config(bg=SUCCESS_COLOR)

    def update_btns(self, items):
        # ✅ 安全更新:仅在主线程调用此方法(由主线程调度)
        for i, item in enumerate(items[:len(self.btns)]):  # 防越界
            bg_color = SUCCESS_COLOR if item.get('is_alive', False) else FAIL_COLOR
            self.btns[i].config(bg=bg_color)

    def configure_btn(self, col):
        master.grid_columnconfigure(col, minsize=BTN_SIZE)

    def attach_btn(self, row, col):
        self.current_btn.grid(
            row=row,
            column=col,
            padx=BTN_X_PADDING,
            pady=BTN_Y_PADDING,
            sticky='wens'
        )

    def attach_all_buttons(self):
        items_count = len(self.items)
        cols = max(1, math.floor(screen_width / BTN_SIZE))  # 防除零
        rows = math.ceil(items_count / cols)
        k = 0
        for row in range(rows):
            partial_items = self.items[row * cols:(row + 1) * cols]
            for col, item in zip(range(cols), partial_items):
                self.create_btn(item, k)
                self.attach_btn(row, col)
                self.configure_btn(col)
                k += 1


# ✅ 模块级单例:整个进程内仅此一份
my_button = MyButtons()

然后,废弃独立运行 monitor.py 和 main.py 的方式,新建统一入口 app.py:

立即学习Python免费学习笔记(深入)”;

# app.py —— 唯一启动文件
import threading
import time
import pickle
from frontend.modules.button import my_button
from frontend.client_socket import client_socket
from frontend.modules.monitor import prepare_monitor  # 假设已将 monitor 逻辑封装为函数


def network_listener():
    """后台线程:持续接收 socket 数据并触发 UI 更新"""
    while True:
        try:
            data = client_socket.client_socket.recv(4096)
            if not data:
                break
            msg = pickle.loads(data)
            if msg:
                print('Received server data:', msg)
                # ✅ 关键:通过 after() 将 UI 更新调度到主线程(Tkinter 线程安全)
                master.after(0, my_button.update_btns, msg)
                client_socket.message = None
        except Exception as e:
            print("Socket error:", e)
            break
        time.sleep(0.1)  # 避免忙等待


if __name__ == "__main__":
    # 启动 GUI 主线程(负责渲染和事件响应)
    gui_thread = threading.Thread(target=prepare_monitor, daemon=False)
    gui_thread.start()

    # 启动网络监听后台线程(非阻塞、不干扰 GUI)
    listener_thread = threading.Thread(target=network_listener, daemon=True)
    listener_thread.start()

    # 保持主线程活跃(GUI 主循环已在 prepare_monitor 中启动)
    # 注意:Tkinter 的 mainloop() 必须在主线程运行,因此 prepare_monitor 应直接调用 master.mainloop()
    try:
        # 若 prepare_monitor 已含 mainloop(),此处无需额外阻塞
        # 否则可加:gui_thread.join()
        pass
    except KeyboardInterrupt:
        print("Shutting down...")

⚠️ 关键注意事项

  • Tkinter 线程限制:所有 Button.config()、widget.grid() 等 GUI 操作必须在主线程执行。使用 master.after(0, func, *args) 是安全调度到主线程的标准做法。
  • 避免竞态条件:若 MyButtons 中有非 GUI 状态(如 self.current_btn),且被多线程读写,需添加 threading.Lock 保护。
  • Socket 连接管理:确保 client_socket 在主线程初始化,且连接未被多线程并发关闭。
  • 进程 ≠ 线程python monitor.py 和 python main.py 是两个进程 → 不可能共享内存;而 threading.Thread 是同一进程内的并发执行 → 共享全部全局变量和对象实例。

✅ 总结

要真正实现“项目内单例复用”,核心不是“怎么导入”,而是确保所有逻辑运行在同一进程内。通过 threading 将 GUI 渲染与后台通信解耦,既满足实时性要求,又严格遵守 Tkinter 的线程约束。button.py 中的 my_button 因模块单例特性天然成为全局唯一实例,无需额外单例模式(如 __new__ 魔术方法),简洁且可靠。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
全局变量怎么定义
全局变量怎么定义

本专题整合了全局变量相关内容,阅读专题下面的文章了解更多详细内容。

93

2025.09.18

python 全局变量
python 全局变量

本专题整合了python中全局变量定义相关教程,阅读专题下面的文章了解更多详细内容。

106

2025.09.18

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

765

2023.08.10

Python 多线程与异步编程实战
Python 多线程与异步编程实战

本专题系统讲解 Python 多线程与异步编程的核心概念与实战技巧,包括 threading 模块基础、线程同步机制、GIL 原理、asyncio 异步任务管理、协程与事件循环、任务调度与异常处理。通过实战示例,帮助学习者掌握 如何构建高性能、多任务并发的 Python 应用。

377

2025.12.24

java多线程相关教程合集
java多线程相关教程合集

本专题整合了java多线程相关教程,阅读专题下面的文章了解更多详细内容。

32

2026.01.21

C++多线程相关合集
C++多线程相关合集

本专题整合了C++多线程相关教程,阅读专题下面的的文章了解更多详细内容。

29

2026.01.21

C# 多线程与异步编程
C# 多线程与异步编程

本专题深入讲解 C# 中多线程与异步编程的核心概念与实战技巧,包括线程池管理、Task 类的使用、async/await 异步编程模式、并发控制与线程同步、死锁与竞态条件的解决方案。通过实际项目,帮助开发者掌握 如何在 C# 中构建高并发、低延迟的异步系统,提升应用性能和响应速度。

103

2026.02.06

Python 多线程与异步编程实战
Python 多线程与异步编程实战

本专题系统讲解 Python 多线程与异步编程的核心概念与实战技巧,包括 threading 模块基础、线程同步机制、GIL 原理、asyncio 异步任务管理、协程与事件循环、任务调度与异常处理。通过实战示例,帮助学习者掌握 如何构建高性能、多任务并发的 Python 应用。

377

2025.12.24

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

76

2026.03.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.5万人学习

Django 教程
Django 教程

共28课时 | 4.9万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号