如何解决JupyterLab开启codeFolding后折叠列遮挡代码首列的问题

该问题是代码折叠区域（gutter）宽度不足或样式偏移导致的，可通过以下方法解决：

方法1：调整Notebook高级配置（优先推荐） #

• 打开JupyterLab顶部菜单栏的Settings→Advanced Settings Editor
• 在左侧配置分类中选择Notebook，切换到用户偏好设置页
• 修改原有codeCellConfig配置，补充折叠边距相关参数，完整参考配置如下：

{
  "codeCellConfig": {
    "codeFolding": true,
    "codeMirror": {
      "foldGutter": {
        "gutterMarkerPadding": "6px"
      }
    }
  }
}

• 保存配置后刷新JupyterLab页面即可生效，该配置会为折叠标记预留足够的横向空间，避免挤压代码显示区域。

方法2：自定义样式强制调整（方法1不生效时使用） #

如果调整核心配置后问题仍然存在，可通过自定义主题样式强制修改折叠区域宽度和代码边距：

• 同样在Advanced Settings Editor中，左侧选择Theme分类
• 在用户偏好设置中添加如下配置：

{
  "overrides": {
    "code-cell .CodeMirror-gutter.CodeMirror-foldgutter": {
      "width": "24px"
    },
    "code-cell .CodeMirror pre.CodeMirror-line": {
      "padding-left": "32px !important"
    }
  }
}

• 保存后刷新页面即可。

额外排查点 #

如果使用了第三方自定义主题，可先切换回JupyterLab默认主题测试，部分第三方主题未适配代码折叠功能的布局参数，也会引发遮挡问题。

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