VSCode需手动注册Conda环境内核：先激活环境并安装ipykernel（pip install），再用python -m ipykernel install --user --name myenv --display-name "Python (myenv)"注册，最后重启VSCode或刷新内核列表。

怎么让VSCode识别Conda环境里的Python内核

VSCode默认不自动扫描Conda环境，必须手动注册或触发内核发现。关键不是“装插件”，而是让jupyter命令能访问到Conda环境中的ipykernel，且VSCode的Jupyter扩展能读取到它。

常见错误现象：Kernel not found、列表里只有Python 3.9 (system)、点选Conda环境后报错ModuleNotFoundError: No module named 'ipykernel'。

• 先确认目标Conda环境已安装ipykernel：

  conda activate myenv<br>python -m pip install ipykernel

• 再把该环境注册为Jupyter内核：

  python -m ipykernel install --user --name myenv --display-name "Python (myenv)"

  （--name是内核标识符，--display-name是VSCode里看到的名字）
• 别用conda install ipykernel代替pip install ipykernel——某些Conda镜像源会装旧版或缺依赖，导致内核启动失败

为什么VSCode里选不到刚注册的内核

注册完内核后，VSCode不会自动刷新内核列表，而且它只在启动时或打开Notebook时扫描一次~/.local/share/jupyter/kernels/（Linux/macOS）或%USERPROFILE%\AppData\Roaming\jupyter\kernels\（Windows）下的目录。路径不对、权限问题、或VSCode没重载Jupyter服务都会导致“看不见”。

• 重启VSCode是最稳妥的刷新方式；如果不想重启，按Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Jupyter: Refresh Kernel List并执行
• 检查内核是否真被写入：运行jupyter kernelspec list，确认输出里包含myenv及其对应路径
• 如果路径里有空格或中文，VSCode可能解析失败——尽量避免在Conda环境名或路径中使用这些字符

Conda环境激活了但Notebook还是用错Python解释器

VSCode里存在两个独立配置层：一是Notebook右上角选择的Kernel（决定运行时Python环境），二是左下角显示的Python Interpreter（决定代码补全、静态检查、调试器用的Python）。二者可以不同，但初学者常混淆，以为选了Kernel就万事大吉。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 务必在Notebook打开状态下，点击右上角的内核名称（如Python (myenv)），从下拉菜单中准确选择你注册的内核，而不是靠左下角解释器“带过去”
• 如果左下角解释器仍是系统Python，不影响Kernel运行，但import提示、类型推导可能不准；想统一，可打开命令面板，运行Python: Select Interpreter，再选./envs/myenv/bin/python（macOS/Linux）或.\envs\myenv\python.exe（Windows）
• 注意：Conda环境路径中的python.exe（Windows）或python（macOS/Linux）必须具有可执行权限，否则内核启动时静默失败

用Mamba或Miniforge创建的环境内核不生效

Mamba和Miniforge默认不修改PATH或CONDA_DEFAULT_ENV，且它们的conda命令行为与Anaconda略有差异，容易导致jupyter找不到环境里的python可执行文件。

• 注册内核时，不要在base环境里执行python -m ipykernel install，而要先conda activate myenv，再运行安装命令——确保调用的是该环境的python
• 验证方法：在激活myenv后运行which python（macOS/Linux）或where python（Windows），看输出路径是否指向myenv目录；如果不是，说明conda activate没生效，可能是shell初始化未完成（如zsh没source conda.sh）
• Miniforge用户尤其注意：某些版本默认禁用conda activate，需先运行conda config --set auto_activate_base true或手动初始化shell

最常被忽略的一点：内核注册命令里的--user参数不能省。去掉它会导致内核写入系统级目录，普通用户无权读取，VSCode就看不到——哪怕jupyter kernelspec list看起来正常，实际VSCode加载时会跳过。