内核列表为空或卡在“connecting to kernel…”说明jupyter未识别可用内核或通信链路中断；需先验证ipykernel是否安装并可导入（python -m ipykernel --version），再以--user参数注册内核，降级至6.26.0版解决windows/wsl socket问题，并确认sys.executable路径与目标环境一致。
内核列表为空或选中后卡在“Connecting to kernel…”
这说明Jupyter根本没识别到可用的Python内核，或者内核进程启动了但通信链路断了。不是前端界面问题，而是后端IPC通道没建起来。
先确认目标环境里真装了ipykernel：激活环境后运行python -m ipykernel --version，有输出才代表模块可导入；没输出就立刻python -m pip install ipykernel。
注册必须带--user参数：python -m ipykernel install --user --name myenv --display-name "Python (myenv)"。不加--user可能装到系统级路径，普通用户权限下VSCode或Jupyter Notebook读不到。
注册完别只点“重载窗口”，要彻底关闭并重启VSCode或浏览器标签页——旧的内核缓存不会自动刷新。
终端报ModuleNotFoundError: No module named 'ipykernel'
这个错误很关键：它说明内核进程确实被拉起来了，但在初始化阶段就崩了，问题出在依赖加载环节。
常见诱因是ipykernel版本太高，尤其在Windows/WSL下，6.27+版本存在socket绑定失败问题。直接降级：python -m pip install "ipykernel==6.26.0"。
别忽略底层依赖冲突：tornado、pyzmq、traitlets这几个包版本必须和ipykernel匹配。如果之前手动升级过tornado到5.x，而notebook要求6.1+，就会静默失败——用pip list | grep -E "(tornado|pyzmq|traitlets)"检查版本组合。
安全软件也可能拦截tcp://127.0.0.1:XXXXX这类本地回环连接，临时关闭杀软或企业防火墙再试一次。
内核名显示正常但import报错说模块不存在
“Python (myenv)”只是个显示标签，不保证实际执行路径就是你conda activate的那个环境。最稳妥的验证方式是在Notebook里运行：
import sys<br>print(sys.executable)
对比你在终端里运行which python（macOS/Linux）或where python（Windows）的结果。两者不一致，说明内核配置指向了错误解释器。
这时候不要改kernel.json文件手动硬编码路径——容易出错且下次注册会被覆盖。正确做法是删掉旧内核：jupyter kernelspec remove myenv，然后在目标环境中重新运行python -m ipykernel install --user --name myenv。
如果你用的是conda环境，优先用conda install ipykernel而非pip install，避免pip与conda混用导致的依赖撕裂。
内核能连上但代码补全/调试功能失效
这通常不是内核连接问题，而是jedi或debugpy等辅助组件没跟上。比如jedi太旧（
检查jedi版本：python -c "import jedi; print(jedi.__version__)"，低于0.18就升级：python -m pip install --upgrade jedi。
VSCode里调试失败还可能因为debugpy未安装或版本不匹配。在对应环境中运行：python -m pip install debugpy，确保版本与VSCode Python扩展兼容（当前稳定组合是debugpy 1.8.0+ + VSCode Python扩展v2026.6+）。
这类问题容易被误判为“内核故障”，其实通信是通的，只是前端功能依赖的子系统没就位。
