# 升级JupyterLab版本
为了提高Notebook的易用性，现将JupyterLab升级至4.4.10版本（2025年稳定版），实现从JupyterLab 3.2.3（2021年老版）的跨版本升级。此次升级对Notebook的性能和启动速度进行了优化，重构了编辑器，强化了调试和协作功能，扩展了更稳定的生态系统，并全面改善了交互体验和内存占用。欢迎您使用。
#### 注意事项
JupyterLab 3.2.3版本计划于2026年10月停止支持新的Notebook实例创建，并且不再提供相应的技术支持，包括新特性更新、漏洞/问题修复、补丁升级以及工单指导和在线排查等客户支持服务，这些将不再适用于ModelArts服务的运维保障。
#### JupyterLab 4版本更新说明
JupyterLab 4版本在用户体验、功能完善和性能提升方面均有显著改进，以下是该版本的主要更新内容。关于JupyterLab 4版本的更多功能信息，请参见[JupyterLab 4官方文档](https://jupyterlab.readthedocs.io/en/stable/index.html)。
表1功能更新说明 
| 功能模块              | 功能描述                                       |
|:---|:---|
| 工作区（Workspaces）特性 | 支持多个工作区，您可以在不同的工作区中组织和管理不同的项目和文件，提升项目管理效率。 |
| 新增Launcher创建工具栏   | 添加新的工具栏，提供了更多的功能访问方式，使操作更加便捷。              |
| 主题框架优化            | 改进主题框架，增强主题的灵活性和兼容性。您可以根据需求进行个性化的界面调整。     |
| 设置界面优化            | 优化设置界面的用户体验，使配置更加直观和易于使用。                  |
| 性能优化和调试功能增强       | 对系统性能进行全面优化，调试功能也得到增强，提升开发体验。              |
| 代码编辑器增强           | 对代码编辑器进行改进，增加更多功能和性能优化，提升代码编写和编辑的体验。       |
| 搜索功能增强            | 增强搜索功能，您可以更快速、更准确地查找所需内容。                  |
| 性能增强              | 整体性能得到提升，系统的响应速度和稳定性都有显著提高。                |
| 支持自定义CSS样式表       | 支持自定义CSS样式表，以便调整界面外观，满足个性化需求。              |
| Markdown支持图表      | 在Markdown文档中支持图表功能，使图文并茂的文档编写变得更加方便。       |
| 虚拟滚动条             | 引入虚拟滚动条，改善大文件或大量内容的滚动体验。                   |
| Workspace UI      | 改进工作区用户界面，提供了更好的可视化效果和操作体验，增强界面友好性。        |
| 文件访问记录            | 支持查看最近打开和关闭文件，便于快速访问常用文件，提升工作效率。           |
| 键盘快捷键改进           | 改进键盘快捷键，提高操作的效率和便捷性。                       |
   
#### 升级JupyterLab版本
您可以任选以下方式升级JupyterLab版本。
#### 方式一：停止Notebook实例并升级JupyterLab版本
**Notebook实例停止后，/home/ma-user/work目录下的数据会保存，其余目录下内容会被清理** 。如果需要保存开发环境，可以通过保存镜像的方式保留开发环境设置。具体操作，请参见[方式二：保存Notebook实例并升级JupyterLab版本]。
当Notebook实例存储类型为云硬盘EVS时，实例停止后，EVS仍将按照每GB规定费用持续计费，直至实例删除。关于计费详情，请参见[开发环境计费项](https://support.huaweicloud.com/price-modelarts/price-modelarts-0010.html)。
1. 停止Notebook实例。
   1. 登录[ModelArts管理控制台](https://console.huaweicloud.com/modelarts)，在左侧导航栏按需选择以下操作。
      - 新版控制台：选择"模型开发与训练 \> Notebook"，进入"Notebook"页面。
      
      - 旧版控制台：选择"开发空间 \> Notebook"，进入"Notebook"页面。
       
   
   2. 在"Notebook"页面的"操作"列，单击目标实例对应的"停止"。
   
   3. 在"停止实例"对话框，阅读提示信息，单击"确定"。 当Notebook实例的"状态"为"停止"，表示停止成功。
      图1Notebook实例状态   
      ![](https://support.huaweicloud.com/devtool-modelarts/figure/zh-cn_image_0000002503554148.png)
      
      
    
2. 升级JupyterLab版本。
   1. 在"Notebook"页面的"操作"列，单击停止实例对应的"启动"。
   
   2. 在"启动Notebook实例"对话框，选择JupyterLab 4版本，按需配置"自动停止"，单击"确定"。
    
3. 查看JupyterLab版本是否升级成功。 在"Notebook"页面，单击实例名称，在"基本信息"页签的"环境配置"区域，在WebIDE下方可以看到JupyterLab 4版本，表示JupyterLab版本升级成功。
   
 
 #### 方式二：保存Notebook实例并升级JupyterLab版本
镜像保存后，默认工作目录是根目录"/"路径。保存的镜像中，安装的依赖包不丢失，**持久化存储的部分（home/ma-user/work目录的内容）不会保存在最终产生的容器镜像中**。VS Code远程开发场景下，在Server端安装的插件不丢失。
1. 保存镜像。具体操作，请参见[保存Notebook实例](https://support.huaweicloud.com/devtool-modelarts/devtool-modelarts_0008.html)。
2. 升级JupyterLab版本。
   1. 在左侧导航栏按需选择以下操作。
      - 新版控制台：选择"资产管理 \> 镜像"。
      
      - 旧版控制台：选择"资产管理 \> 镜像管理"。
       
   
   2. 在"已注册镜像"页签，单击[步骤1]保存的镜像名称。
   
   3. 在"操作"列，单击"创建Notebook"。
   
   4. 在"创建Notebook"页面，选择JupyterLab 4版本，按需修改其他参数，单击"立即创建"。 当Notebook实例的"状态"为"运行中"，表示Notebook创建成功。
      
    
3. 查看JupyterLab版本是否升级成功。 在"Notebook"页面，单击实例名称，在"基本信息"页签的"环境配置"区域，在WebIDE下方可以看到JupyterLab 4版本，表示JupyterLab版本升级成功。