Jupyter Notebook中模块对象如何访问全局配置变量？

嘿，这个问题我之前帮不少人捋清楚过——本质上是模块的命名空间和Notebook单元格的命名空间是相互隔离的：你的模块代码运行在自己独立的命名空间里，默认根本看不到用户在配置单元格里定义的变量。下面给你几个实用的解决方案，按推荐程度排序：

1. 显式传递配置变量（最推荐，符合Python规范） #

这是最清晰、最不容易出bug的做法，让用户在调用函数/实例化类时，把配置变量直接传进去。

示例代码：

# 第三个单元格（用户配置）
api_key = "my_secure_key"
request_timeout = 30
db_connection_url = "sqlite:///local_db.db"

# 后续调用单元格
from my_module import fetch_data, DatabaseClient

# 调用函数时传参
fetch_data(api_key=api_key, timeout=request_timeout)

# 实例化类时传参
db_client = DatabaseClient(db_url=db_connection_url)
db_client.get_records()

这种方式的优点是逻辑透明，函数/类的依赖一目了然，后期维护和测试都很方便。

2. 用全局配置对象（便捷且可控） #

你可以在模块里定义一个专门的配置类或字典，让用户在配置单元格里直接修改这个对象的属性，模块里的函数直接读取这个对象。

模块代码（my_module.py）：

# 定义全局配置类
class AppConfig:
    api_key = ""
    timeout = 10
    db_url = ""

def fetch_data():
    if not AppConfig.api_key:
        raise ValueError("请先在配置单元格设置api_key！")
    # 这里直接使用AppConfig里的配置
    print(f"使用密钥 {AppConfig.api_key} 请求数据，超时时间 {AppConfig.timeout}s")

Notebook配置单元格：

from my_module import AppConfig
AppConfig.api_key = "my_secure_key"
AppConfig.timeout = 30

后续调用单元格：

from my_module import fetch_data
fetch_data()  # 直接调用，不需要传参

这种方法兼顾了便捷性和可读性，用户修改配置的操作也很直观。

3. 读取调用者的全局命名空间（不推荐，仅适合简单场景） #

如果实在不想传参或者用配置对象，可以用inspect模块让模块代码“主动”获取Notebook单元格的全局变量。但这种方法有点“黑魔法”，可读性差，调用层级复杂时容易出问题。

模块代码（my_module.py）：

import inspect

def _get_notebook_var(var_name):
    # 获取调用者（Notebook单元格）的全局命名空间
    caller_frame = inspect.stack()[1][0]
    return caller_frame.f_globals.get(var_name)

def fetch_data():
    api_key = _get_notebook_var("api_key")
    timeout = _get_notebook_var("request_timeout")
    if not api_key:
        raise ValueError("请在配置单元格设置api_key变量！")
    # 后续逻辑

Notebook配置单元格：

api_key = "my_secure_key"
request_timeout = 30

后续调用单元格直接调用fetch_data()即可，但这种方式不推荐用于复杂项目。

4. 使用环境变量（适合敏感配置） #

如果配置里有敏感信息（比如密钥、密码），可以让用户在配置单元格里设置环境变量，模块里读取环境变量，避免敏感数据直接暴露在Notebook变量中。

Notebook配置单元格：

import os
os.environ["APP_API_KEY"] = "my_secure_key"
os.environ["APP_TIMEOUT"] = "30"

模块代码（my_module.py）：

import os

def fetch_data():
    api_key = os.getenv("APP_API_KEY")
    timeout = int(os.getenv("APP_TIMEOUT", 10))  # 10是默认值
    if not api_key:
        raise ValueError("请设置APP_API_KEY环境变量！")
    # 后续逻辑

内容的提问来源于stack exchange，提问作者Jubbles