为了让你的 Python 脚本能顺利找到并导入位于特定位置（例如项目根目录或其他自定义路径）下的模块，你需要将该项目目录添加到系统的模块搜索路径列表 `sys.path` 中。这是因为在默认情况下，Python只会查找标准库以及某些预配置的位置来定位所请求的模块；如果你试图访问非标准位置中的资源，则必须明确告知解释器去哪里找这些东西。 下面是一些常用的方法把当前工作的项目文件夹加入到 `sys.path` 里： ### 方法一：修改 PYTHONPATH 环境变量 最简单的一种办法就是在启动 Python 解释器之前设置好环境变量 `PYTHONPATH` 。这会使得所有后续创建的新进程都会继承这个值，并且影响其内部对模块解析的行为模式。对于大多数操作系统来说，可以在命令行终端执行类似如下的指令： - **Windows** ```bash set PYTHONPATH=%PYTHONPATH%;C:\path\to\your\project ``` - **Linux / macOS** ```bash export PYTHONPATH=$PYTHONPATH:/path/to/your/project ``` 不过这种方法只适用于临时性的改动，在关闭 Shell 终端之后就会失效。 ### 方法二：在代码开始处手动插入 sys.path 更常见的情况是你希望在一个单独的应用程序中完成这项任务而不改变全局设置。那么就可以直接向 `sys.path` 列表追加新的项，通常放在主入口点附近，比如 main 函数的第一句或者作为首段被执行的部分： ```python import os import sys current_dir = os.path.dirname(os.path.abspath(__file__)) parent_dir = os.path.dirname(current_dir) if parent_dir not in sys.path: sys.path.insert(0, parent_dir) # 插入第一个元素 # 接着即可按常规方式引用同级或上级目录中的包啦~ ``` 这里用了 `os.path` 提供的一系列工具函数帮助构造绝对路径字符串形式的目标地址。另外值得注意的是使用了条件判断以避免重复增加同一个路径造成不必要的冗余。 ### 方法三：使用 -m 参数运行模块并且保证正确的工作目录 当你要测试某个特定子包的时候，确保你在项目的根目录下调用 python 执行器，并带上 `-m` 标志去指明要加载的具体模块名而不是它的完整文件系统路径。这样做能自动帮你处理好相关的路径映射问题而无需额外操心路径管理事宜。 ```bash cd path/to/my_project_root python -m my_package.my_module ``` 这种方式的好处在于它不会干扰其他的正在使用的 `PYTHONPATH` 设置，同时也能很好地支持相对路径风格的导入语法。 --- 综上所述，无论选择哪种方案都取决于具体的场景和个人偏好，但无论如何都要记得保持良好的组织习惯和清晰的理解有关作用域的概念哦！