虚拟环境下配置Jupyter Notebook实现自动同步保存ipynb与py文件的问题

AI 小北

2026-9-29

默认Jupyter Notebook会将配置文件生成到系统用户根目录的.jupyter文件夹下，通过自定义配置存储路径即可实现虚拟环境专属配置与全局配置的隔离，具体操作步骤如下：

虚拟环境内配置Jupyter Notebook自动同步保存py文件操作步骤

第一步：安装虚拟环境内的依赖组件
激活虚拟环境后执行以下命令，避免调用全局jupyter导致配置生成路径异常，同时安装同步功能依赖的jupytext：
```
pip install jupyter jupytext
```
第二步：指定虚拟环境内的配置存储目录
在已激活的虚拟环境终端中执行对应命令，设置jupyter配置文件的存储路径为虚拟环境内的目录（示例中虚拟环境根目录为./venv，可根据你的实际路径修改）：
- macOS/Linux 终端：
```
export JUPYTER_CONFIG_DIR=./venv/.jupyter
```
- Windows CMD：
```
set JUPYTER_CONFIG_DIR=./venv/.jupyter
```
- Windows PowerShell：
```
$env:JUPYTER_CONFIG_DIR = "./venv/.jupyter"
```
如需每次激活虚拟环境自动加载该配置，可把上述环境变量设置命令添加到虚拟环境激活脚本末尾：macOS/Linux 对应路径为./venv/bin/activate；Windows 对应路径为./venv/Scripts/activate.bat（CMD）/Activate.ps1（PowerShell）
第三步：生成虚拟环境专属配置文件
执行配置生成命令，此时生成的配置文件会存储在刚才指定的虚拟环境内的.jupyter目录下：
```
jupyter notebook --generate-config
```
第四步：修改配置文件
打开刚才生成的./venv/.jupyter/jupyter_notebook_config.py文件，在任意位置添加以下两行配置：
```
c.NotebookApp.contents_manager_class="jupytext.TextFileContentsManager"
c.ContentsManager.formats = "ipynb,py"
```
第五步：验证生效
保持当前终端的虚拟环境激活状态，执行jupyter notebook启动服务，新建ipynb文件后查看所在目录，会自动生成同名的.py格式同步文件。