寻求更Pythonic的Python模块源路径配置方案

我有一个面向课堂教学的Python包，主要供学生在调试器中交互式探索使用。现在遇到了一个路径适配问题：当教程在Spyder IDE中打开时，当前工作目录是教程所在的文件夹；但如果用命令行的py命令运行教程，通常是从包的根目录启动的。

为了让Python能找到包的源文件，我目前在tutorials文件夹里放了一个context.py，内容如下：

import os
import sys
sys.path.insert(0, os.path.abspath("."))
sys.path.insert(0, os.path.abspath(".."))

然后每个教程开头都要import context。这个方法确实能用，但总感觉太临时、不够优雅，想问问有没有更Pythonic的解决方式？

方案1：使用可编辑模式安装包（最推荐） #

这是Python生态里处理开发/教学场景最标准的方式，完全不需要手动修改sys.path。只需要让学生在包的根目录（也就是包含setup.py或pyproject.toml的文件夹）执行以下命令：

pip install -e .

-e参数代表“可编辑（editable）”模式，它会把你的包链接到Python的site-packages目录里，不管学生在哪个目录运行教程，都能直接导入包的模块，完全不用管路径问题。对课堂教学来说，只需要让学生执行一次这个命令，后续所有教程都能正常运行，非常省心。

方案2：改进路径定位逻辑（如果不想用安装方式） #

如果出于某些原因不想让学生安装包，也可以把context.py的写法改得更稳健，不再依赖当前工作目录：

import os
import sys
# 自动定位包的根目录：当前文件在tutorials文件夹，往上一级就是根目录
package_root = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
sys.path.insert(0, package_root)

这里用os.path.dirname(__file__)获取context.py自身的路径，再通过..定位到包根目录，不管当前工作目录是哪里，都能准确找到包的位置，比原来依赖./和../的写法可靠得多，也更符合Python的路径处理规范。

方案3：设置PYTHONPATH环境变量 #

另一种方式是让学生设置PYTHONPATH环境变量，指向包的根目录。这样Python在启动时会自动把这个路径加入模块搜索路径，不需要任何代码修改。不过对新手学生来说，设置环境变量可能有点门槛，适合有一定基础的教学场景：

• Windows命令行：set PYTHONPATH=包的根目录路径
• Linux/macOS终端：export PYTHONPATH=包的根目录路径

备注：内容来源于stack exchange，提问作者Petr Krysl