摘要jupyterlab-lsp为Jupyter Notebook和.py文件提供类似VS Code/PyCharm的IDE功能包括智能提示、跳转定义、自动补全、实时诊断等支持多语言且无需内核运行即可实现静态分析。2025-2026年最新版本推荐搭配JupyterLab 4.x使用支持Python≥3.9。安装需配置语言服务器如pylsp或pyright并可通过个性化设置优化补全速度与诊断规则。常见问题如跳转限制或卡顿可通过符号链接或调整超时参数解决。该扩展显著提升JupyterLab的开发让你的 Jupyter Notebook 和 .py 文件拥有接近VS Code / PyCharm的智能提示、跳转定义、自动重命名、实时诊断等 LSP 功能而且支持多语言2025–2026 年最新版本已经非常成熟强烈推荐升级使用。效果如下一、jupyterlab-lsp 到底能干啥核心亮点功能效果描述是否需要内核运行悬停提示Hover鼠标悬停 按 Ctrl 显示函数签名、文档、类型信息否实时诊断Diagnostics红/橙色波浪线标出错误/警告鼠标悬停看详细说明否跳转定义 / 查找引用Alt 点击 / 右键菜单跳转Alt o 返回否引用高亮光标放在变量/函数上全文件同名位置高亮否自动补全 连续提示输入 . 自动触发 / 可开启打字即提示continuousHinting部分静态分析无需函数签名提示输入 ( 自动弹出参数提示支持多重载否纯静态补全Kernel-less即使内核没启动 / 卡死也能补全Julia、Python、R 效果都很强否重命名符号F2 / 右键 → 重命名全文件/多文件同步改名否诊断面板命令面板搜 “Show diagnostics panel”可排序、跳转、过滤、复制错误信息否最爽的一点内核补全DataFrame 列名、字典 key 等动态内容 LSP 静态分析补全可以同时存在而且可以设置谁优先、谁禁用。二、2026 年安装步骤推荐方式环境要求非常重要JupyterLab≥4.1.0且5.0.0a0目前 5.x 系列还未正式全面适配建议暂时停留在 4.xPython≥3.9推荐安装流程conda 用户# 1. 创建新环境强烈建议conda create -n jlab-lsppython3.11conda activate jlab-lsp# 2. 安装 JupyterLab 4.x jupyterlab-lsp2025-2026 最新稳定版condainstall-c conda-forgejupyterlab4.3jupyterlab-lsp# 或者用 pip版本自己控制更灵活pipinstalljupyterlab4.1.0,5.0.0a0jupyterlab-lsp5.2.0安装常用语言服务器选你需要的装Python最常用# 推荐 pylsp 全家桶包含 flake8、pydocstyle、black 等pipinstallpython-lsp-server[all]# 或者更现代的基于 pyright 的方案2025年后很多人转用pipinstallbasedpyright# 或 pyrightR 语言condainstall-c conda-forge r-languageserver# 或R -einstall.packages(languageserver)Julia需要额外装 LanguageServer.jl其他语言TypeScript、bash、markdown 等请参考官方支持列表Language Servers 页面安装完语言服务器后重启 JupyterLab即可生效。三、推荐的个性化配置放 settings 里打开Settings → Advanced Settings Editor → jupyterlab-lsp最常用的一段配置Python 用户{python:{kernelCompletionsTimeout:0.4,continuousHinting:true,disableCompletionsFrom:[Kernel]// 只用 LSP 补全更快、更准},language_servers:{pylsp:{serverSettings:{pylsp.plugins:{pycodestyle:{enabled:false},pyflakes:{enabled:false},flake8:{enabled:true},pydocstyle:{enabled:true},autopep8:{enabled:false}}}}}}想用基于 pyright 的静态分析可以尝试安装basedpyright并在配置中启用。四、常见问题 小技巧Q1为什么有些文件跳转不到系统包 / venv 里的定义Linux/macOS 用户请在 notebook 目录下创建符号链接只做一次cd你常用的notebook目录ln-s / .lsp_symlink然后启动 jupyterlab 时加参数jupyter lab --ContentsManager.allow_hiddenTrueQ2补全太慢 / 卡顿怎么办调低kernelCompletionsTimeout默认 0.6s → 0.3s直接禁用内核补全只用 LSP见上面配置使用更快的语言服务器如 basedpyright 代替 pylspQ3支持 JupyterLab 5.x 吗截至 2026 年 1 月官方仍推荐 4.x 系列。5.x 支持正在开发中建议暂时不要强行升级。最后一句话总结jupyterlab-lsp 是目前 Jupyter 生态里最接近现代 IDE 体验的扩展。装上它你会发现自己越来越不想离开 JupyterLab 写代码了。有问题欢迎留言区讨论 也欢迎点个赞收藏下次直接翻出来用完