Jupyter模块查找机制及路径配置问题咨询

嘿，我完全懂你的感受——官方文档在这种基础问题上确实有点藏着掖着，我当初踩这个坑的时候也懵了好一阵。下面给你一步步讲清楚：

一、如何指定Jupyter Notebook的模块查找路径 #

有三种常用方法，从临时到永久都能覆盖：

• 临时生效（单Notebook会话）：直接在Notebook的代码单元格里添加路径，用完就失效，适合临时测试：

  import sys
  # 替换成你实际的模块存放路径
  sys.path.append("/home/yourname/custom-modules")
  

• 永久生效（所有Jupyter/IPython会话）：配置IPython的启动脚本，让它每次启动自动加载路径：

  1. 先创建IPython启动脚本目录（如果不存在的话）：

     mkdir -p ~/.ipython/profile_default/startup
     

  2. 在这个目录里新建一个00-add-path.py文件，把上面的sys.path.append代码写进去保存。之后每次打开Jupyter，这个路径都会自动加入模块查找列表。

• 全局生效（所有Python环境）：修改系统的PYTHONPATH环境变量，这会影响所有Python程序，包括Jupyter：

  • Linux/macOS：打开你的shell配置文件（比如~/.bashrc或~/.zshrc），添加一行：

    export PYTHONPATH="/your/custom/path:$PYTHONPATH"
    

    然后运行source ~/.bashrc（或对应的配置文件）让修改生效。
  • Windows：打开「系统属性-高级-环境变量」，新建系统变量PYTHONPATH，值填你的模块存放路径即可。

二、关于jupyter --path里的data目录 #

这个不是Python模块的查找目录哦！Jupyter的data目录是用来存放它自身的数据文件的——比如扩展插件、主题、配置模板这些内容，和Python模块的查找路径完全没关系。你可以在Notebook里运行import sys; print(sys.path)，看到的才是当前生效的模块查找路径列表。

三、需要编辑哪个文件修改路径？ #

如果想通过配置文件永久解决，最推荐的是上面提到的IPython启动脚本~/.ipython/profile_default/startup/00-add-path.py，或者修改PYTHONPATH环境变量。Jupyter本身的配置文件（比如jupyter_notebook_config.py）主要负责Notebook的服务端设置，和模块路径无关，不用去修改它。

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