VSCode Jupyter无法加载conda环境中IPython实例问题求助

针对Linux和MacOS下出现的VSCode Jupyter内核仅显示系统Python、conda环境短暂显示后消失的问题，可按以下步骤排查修复：

1. 手动注册conda环境内核 #

激活目标conda环境后，手动安装并注册内核，规避自动注册异常：

conda activate your_env_name
python -m ipykernel install --user --name your_env_name --display-name "Python (your_env_name)"

注册完成后，内核配置文件会存放在~/.local/share/jupyter/kernels/your_env_name目录下，确保该目录存在且配置正常。

2. 检查VSCode Jupyter扩展设置 #

• 打开VSCode设置（Ctrl+, / Cmd+,），搜索jupyter.kernels.ignoreList，确认列表中未包含你的conda环境内核名称
• 搜索jupyter.jupyterCommand，若设置了固定路径，确保路径指向conda环境内的jupyter可执行文件（可通过conda activate your_env_name && which jupyter获取）；若为空则保持默认，让VSCode自动检测

3. 重置Jupyter内核缓存 #

打开VSCode命令面板（Ctrl+Shift+P / Cmd+Shift+P），输入并执行Jupyter: Reset Kernels，完成后重启VSCode，清除旧的内核缓存数据。

4. 验证conda环境依赖完整性 #

激活环境后，确认核心依赖已正确安装：

conda list | grep -E "ipython|ipykernel|jupyter"

若有缺失，重新安装：

conda install ipython ipykernel jupyter -y

5. 排查文件权限问题 #

检查内核配置目录的权限，确保当前用户可读写：

ls -ld ~/.local/share/jupyter/kernels/your_env_name

若权限不足，执行以下命令调整：

chmod -R 755 ~/.local/share/jupyter/kernels/your_env_name

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