如何在Python中跨文件共享变量（模块级变量导入详解）

2026-01-29 Python

本文详解python中通过模块导入实现跨文件变量共享的正确方法，涵盖模块作用域原理、import语句执行机制、常见错误及最佳实践，并提供可直接运行的示例代码。

在Python中，import 并非“复制变量”，而是加载并执行目标模块的顶层代码，并将其命名空间暴露给当前作用域。因此，若想在 test2.py 中使用 test1.py 中定义的变量 rep_date，必须明确从该模块中访问其属性，而非直接引用变量名。

✅ 正确做法：从模块中显式引用变量

假设项目结构如下（推荐扁平结构，便于理解）：

project/
├── test1.py   # 定义 rep_date
└── test2.py   # 导入并使用 rep_date

test1.py（注意：此处建议避免交互式 input() 作为模块顶层语句，见后文说明）：

# test1.py
rep_date = input("Please enter report date (E.g. 01/01/2023 → enter 010123): ")

test2.py（关键：使用 test1.rep_date 访问）：

# test2.py
import test1  # 执行 test1.py 全部顶层代码（包括 input()）
print("Date entered: " + test1.rep_date)  # ✅ 正确：通过模块名限定访问

⚠️ 运行 python test2.py 时，input() 将在 test2.py 启动时被触发 —— 因为 import test1 会立即执行 test1.py 中所有顶层语句。

? 更灵活的方案：封装为函数（推荐）

为避免副作用（如重复输入、模块加载即执行），应将逻辑封装为函数：

test1.py：

Python之模块学习中文WORD版

本文档主要讲述的是Python之模块学习；python是由一系列的模块组成的，每个模块就是一个py为后缀的文件，同时模块也是一个命名空间，从而避免了变量名称冲突的问题。模块我们就可以理解为lib库，如果需要使用某个模块中的函数或对象，则要导入这个模块才可以使用，除了系统默认的模块（内置函数）不需要导入外。希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看

def get_report_date():
    return input("Please enter report date (E.g. 01/01/2023 → enter 010123): ")

test2.py：

import test1

rep_date = test1.get_report_date()  # ✅ 按需调用，控制执行时机
print("Date entered: " + rep_date)

或使用 from ... import 语法简化引用：

from test1 import get_report_date

rep_date = get_report_date()
print("Date entered: " + rep_date)

❌ 常见错误与说明

错误写法：print("Date entered: " + rep_date)
→ NameError: name 'rep_date' is not defined：rep_date 属于 test1 模块的命名空间，未自动导入到当前作用域。
错误假设：认为 import test1 会“把变量复制进来”
→ 实际是创建了对模块对象的引用，所有变量需通过 test1.xxx 访问。
相对导入不适用此场景：问题中文件为独立脚本（非包内子模块），无需 from . import ...；相对导入仅适用于 package.submodule 结构，且需以 python -m package.module 方式运行。