Windows10下JupyterLab高级设置编辑器出现重复项问题

该故障由Windows系统默认开启的8.3短文件名兼容机制触发：当目录名长度超过8个字符时，Windows会自动生成带~前缀的短别名用于兼容老版本DOS程序。JupyterLab扫描扩展路径时未对短别名做去重处理，会将长名、短名两个路径识别为不同的扩展，最终出现设置条目重复、修改配置时生成两个同名目录的问题。

方案1：修改系统配置（永久解决） #

• 关闭所有JupyterLab进程，先删除已生成的重复配置目录：打开%USERPROFILE%\.jupyter\lab\user-settings\@jupyterlab路径，删除所有带~前缀的目录。
• 以管理员身份启动命令提示符（cmd），执行以下命令关闭用户目录所在盘符的8.3短文件名生成功能（如果用户目录不在C盘，将命令中的C:替换为对应盘符）：

  fsutil 8dot3name set C: 1
  

• 重启电脑后，继续在管理员cmd中执行以下命令清理已生成的短别名，将命令中的你的用户名替换为实际Windows用户名：

  fsutil 8dot3name strip /s C:\Users\你的用户名
  

• 重新安装JupyterLab验证：

  pip uninstall jupyterlab -y
  pip install jupyterlab
  

  启动后进入高级设置编辑器，重复条目会消失，修改配置也不会再生成带~的重复目录。

方案2：不修改系统配置（临时解决） #

如果不想改动Windows系统规则，可以手动指定JupyterLab的配置存储路径避开短名扫描：

• 新建一个路径简单的目录，例如C:\jupyterlab_settings
• 打开系统环境变量设置，新增变量名为JUPYTERLAB_SETTINGS_DIR，变量值为你新建的目录路径
• 重启JupyterLab即可生效，后续所有配置都会写入该目录，不会触发重复问题。

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