jupyter lab补全默认需手动tab触发，失效主因是ipython内核拒绝返回候选列表；推荐用jupyterlab-lsp+python-lsp-server实现智能补全，支持悬浮签名、跳转定义等功能。
默认不自动弹出，必须手动按 Tab 才触发补全 —— 这是 Jupyter Lab 的行为底线，所有方案都绕不开这个前提，但可以做到“输入即提示”。
为什么 Tab 补全在 Jupyter Lab 里经常失效
不是前端没响应，而是后端 IPython 内核拒绝返回候选列表。常见原因包括：
-
use_jedi=True但环境里没装jedi或版本冲突（尤其在容器镜像、M1 Mac、conda 环境中高频出现） -
greedy=False（默认值），导致df.<tab></tab>这类链式调用直接跳过补全 - 内核未重启：改完配置后只刷新页面没重启 kernel，
%config不生效 - Python 语言服务器（LSP）未启动或崩溃，
jupyterlab-lsp显示灰色图标即为异常
用 jupyterlab-lsp + python-lsp-server 实现真·智能补全
这是目前最稳定、功能最全的方案，支持函数签名悬浮、跳转定义、实时诊断，且不依赖运行时内核。
- 安装命令（推荐在干净虚拟环境中执行）：
pip install jupyterlab-lsp -i https://pypi.tuna.tsinghua.edu.cn/simple<br>pip install 'python-lsp-server[all]' -i https://pypi.tuna.tsinghua.edu.cn/simple
- 重启 Jupyter Lab 后，检查左下角状态栏是否出现
LSP图标；若为灰色，说明服务未就绪，可终端执行pyls --version验证 - 启用连续提示：进入
Settings > Advanced Settings Editor > Code Completion，在用户设置 JSON 中添加{"continuousHinting": true}保存后刷新页面 - 注意：若用 conda，避免混用 pip 和 conda 安装 LSP 相关包，易引发
ImportError: cannot import name 'get_lsp_info'
不装扩展，仅靠 IPython 内核快速启用基础补全
适合临时调试、CI 环境或不想引入额外依赖的场景，补全逻辑走内核直连，无悬浮文档、无类型推断。
- 在 notebook 单元格中运行：
%config IPCompleter.greedy = True<br>%config IPCompleter.use_jedi = False
- 必须重启 kernel（不是刷新页面），否则配置不加载
- 效果：输入
pd.read_<tab></tab>会列出所有以read_开头的方法；但pd.DataFrame().<tab></tab>仍可能为空，因未实例化对象 - 风险：设
greedy=True后，某些表达式（如func()[0].<tab></tab>）会真实执行左侧代码，慎用于有副作用的函数
容易被忽略的关键点
补全不是“装了就灵”，它高度依赖环境一致性：
- 确保
python-lsp-server和你 notebook 中实际使用的 Python 解释器是同一个 —— 查看右上角 kernel 名称，再在终端执行which python对比路径 - Mac M1/M2 用户若遇到
zsh: illegal hardware instruction，说明pylsp二进制不兼容，需重装：pip uninstall python-lsp-server && pip install --no-binary :all: python-lsp-server - 使用
continuousHinting: true后，每敲一个字符都发请求，网络不稳定或服务器负载高时会出现卡顿，此时建议关掉该选项，退回Tab触发模式
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
