jupyterlab-lsp：让 JupyterLab 拥有 IDE 级代码辅助

数据科学圈子里，JupyterLab 几乎是标配。写 Python、R、Julia 都顺手，交互式执行代码的体验确实好。但它一直有个短板：代码辅助功能偏弱。没有准确的自动补全，没有实时的错误提示，跳转到定义也很麻烦。这些问题在写小脚本时不明显，项目一复杂就很折磨人。

jupyterlab-lsp 这个插件就是来解决这些问题的。它把 Language Server Protocol 接进了 JupyterLab，让 Notebook 和文件编辑器都能用上 IDE 级别的代码辅助功能。目前这个项目在 GitHub 上有近两千 Star，在 Jupyter 生态里算是比较成熟的方案。

核心功能一览

这个插件覆盖的功能很全。Hover 查看函数签名和文档说明，鼠标悬停有下划线的地方按 Ctrl 就能弹出提示。代码里的错误和警告会实时标出来，红线是严重错误，橙线是警告，悬停能看到详细说明。

跳转定义和查找引用支持鼠标快捷键，也能从右键菜单进入。光标放在变量或函数上，所有用到的地方都会高亮显示。自动补全除了触发字符（比如 Python 里的点号）会自动弹出，还可以开启连续提示模式，边打字边出建议。

比较实用的是无 Kernel 自动补全。以前 JupyterLab 的补全依赖运行中的 Kernel，Kernel 没启动就什么都没有。jupyterlab-lsp 基于静态分析提供补全建议，不需要 Kernel 也能用。如果 Kernel 在运行，它的建议和 Language Server 的建议会合并显示；Kernel 响应慢的话，默认 0.6 秒内优先展示 Language Server 的结果，也可以配置成跳过 Kernel 建议。

重命名变量、函数也支持，在 Notebook 和文件编辑器里都能用，快捷键是 F2 或者右键菜单。还有一个诊断面板，可以按严重程度排序，快速跳转定位问题。

多语言支持

虽然示例大多是 Python，但这个插件支持的语言很多。R、bash、TypeScript 都能用，只要装对应的 Language Server 就行。Python 用 pylsp，R 用 languageserver，安装文档里列了完整的支持列表和安装命令。

安装和配置

安装不复杂。需要 JupyterLab 4.1.0 以上版本、Python 3.9 以上。用 conda 的话一条命令搞定：

conda install -c conda-forge 'jupyterlab>=4.1.0,<5.0.0a0' jupyterlab-lsp

pip 也可以。装完 Language Server 之后重启 JupyterLab 就行。

每个 Language Server 都可以在 JupyterLab 的高级设置里单独配置。比如 pylsp 可以开关 pydocstyle、flake8 这些插件，调整诊断规则。也可以用本地配置文件，像 pycodestyle 的配置文件来忽略特定错误码或修改最大行宽。

适合谁用

如果你在 JupyterLab 里写比较复杂的代码，经常需要跳转定义、批量重命名、查看文档，这个插件能明显提升效率。做数据科学、机器学习开发的人应该会比较喜欢。

对纯新手来说，安装 Language Server 这一步可能需要花点时间。但配好一次之后，后续的使用体验接近 VS Code 级别的代码辅助，对于重度 JupyterLab 用户来说是值得投入的。

Code 级别的代码辅助，对于重度 JupyterLab 用户来说是值得投入的。