如何使用Python代码启动Jupyter Notebook并指定目标工作文件夹？

前置要求 #

• 已在当前Python环境安装Jupyter Notebook，未安装的可以执行pip install notebook完成安装
• 提前创建好你要设置为工作目录的文件夹，确认路径可正常访问

完整实现代码 #

import subprocess
import os

# 替换为你的预设工作目录路径
# Windows路径示例："C:\\Users\\用户名\\Documents\\jupyter_workspace"
# macOS/Linux路径示例："/Users/用户名/jupyter_workspace"
PRESET_WORK_DIR = "/path/to/your/target/directory"

def run_jupyter_with_custom_dir(work_dir):
    # 校验目录合法性
    if not os.path.isdir(work_dir):
        raise FileNotFoundError(f"指定目录 {work_dir} 不存在，请先创建该目录")
    
    # 构造启动命令
    start_cmd = [
        "jupyter",
        "notebook",
        f"--notebook-dir={work_dir}",
        # 不需要自动打开浏览器的话，取消注释下面一行
        # "--no-browser",
        # 需要自定义端口的话，取消注释下面一行，修改为你想要的端口号
        # "--port=8899"
    ]

    try:
        # 启动Jupyter服务
        subprocess.run(start_cmd, check=True, capture_output=False, text=True)
    except subprocess.CalledProcessError as e:
        print(f"启动失败，错误信息：{e.stderr}")
    except KeyboardInterrupt:
        print("\nJupyter服务已手动停止")

if __name__ == "__main__":
    run_jupyter_with_custom_dir(PRESET_WORK_DIR)

相关说明 #

• 代码通过Jupyter官方自带的--notebook-dir参数指定工作目录，优先级高于全局配置，不需要修改Jupyter的配置文件
• 如果存在多个Python环境，要调用指定环境下的Jupyter，可以把命令里的jupyter替换为对应环境中Jupyter可执行文件的绝对路径，避免调用错乱
• 按Ctrl+C可以终止正在运行的Jupyter服务

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