如何将修改后的JupyterLab源码构建为默认运行版本?
让修改后的JupyterLab源码成为本地默认运行版本
我帮你梳理一下问题的核心:你已经通过开发模式安装了JupyterLab,也完成了前端构建,但默认运行时JupyterLab还是加载系统环境(/opt/conda/share/jupyter/lab)的预构建资产,而非你修改后的源码构建。只有加--dev-mode才生效,是因为这个参数会强制JupyterLab加载源码目录的构建产物。下面是具体的解决流程,帮你把修改后的版本设为默认:
1. 确认开发安装的正确性
先回到你的JupyterLab源码根目录,确保Python包已经以开发模式正确安装(这一步会让jupyter命令直接调用源码中的Python逻辑):
pip install -e .
2. 完整构建前端资产(包含自定义packages)
在源码根目录下执行前端依赖安装和全量构建,确保你的所有代码修改都被编译到构建产物中:
jlpm install jlpm run build:core # 先构建核心packages jlpm run build # 完成所有前端代码的构建
执行完后,源码目录下会生成build/文件夹,里面就是包含你修改的最新前端资产。
3. 修改JupyterLab配置,默认加载源码构建
我们需要修改配置,让JupyterLab默认使用你源码中的构建产物,而不是系统目录的:
3.1 生成配置文件
如果还没有JupyterLab的配置文件,执行以下命令生成:
jupyter lab --generate-config
配置文件默认路径:
- Linux/macOS:
~/.jupyter/jupyter_lab_config.py - Windows:
C:\Users\<你的用户名>\.jupyter\jupyter_lab_config.py
3.2 调整配置项
打开配置文件,找到(或手动添加)以下两个配置项,修改成对应的内容:
# 启用开发模式,让JupyterLab加载源码中的构建产物 c.LabApp.dev_mode = True # 指定你源码根目录下build文件夹的绝对路径,替换成你实际的路径 c.LabApp.serve_dir = '/path/to/your/jupyterlab-source/build'
4. 验证效果
现在直接运行jupyter lab,不需要加--dev-mode参数,就能看到你修改后的代码效果了!
额外提示
- 后续如果再修改前端代码,只需要重新执行
jlpm run build,然后重启JupyterLab就能生效,不用再调整配置。 - 要是想回到系统默认的JupyterLab版本,只需要把配置文件里的
c.LabApp.dev_mode改成False,并注释掉serve_dir这一行即可。
内容的提问来源于stack exchange,提问作者Maya Harel
相关产品推荐
相关产品推荐

