Mac M4环境VS Code运行.ipynb遇ipykernel安装问题求助

步骤1：手动修复虚拟环境的pip #

打开终端，先激活你的.venv虚拟环境：

source .venv/bin/activate

检查环境内是否存在pip：

which pip

如果无输出，说明虚拟环境的pip未正确安装，执行以下命令补装并升级：

python -m ensurepip --upgrade

步骤2：在虚拟环境内安装并注册ipykernel #

确认pip可用后，直接在激活的环境中执行安装：

pip install ipykernel -U --force-reinstall

安装完成后，将当前虚拟环境注册为Jupyter内核：

python -m ipykernel install --user --name=.venv

步骤3：在VS Code中指定正确的内核 #

打开.ipynb文件后，点击右上角显示当前内核（如"Python 3.13.2"）的区域，选择刚刚注册的.venv内核，再尝试运行单元格。

步骤4：强制VS Code使用虚拟环境的Python解释器 #

• 打开VS Code命令面板（Cmd+Shift+P），输入Python: Select Interpreter，手动选择.venv/bin/python
• 检查项目根目录的.vscode/settings.json，确保配置了正确的路径：

  {
    "python.pythonPath": "${workspaceFolder}/.venv/bin/python",
    "jupyter.pythonPath": "${workspaceFolder}/.venv/bin/python"
  }
  

步骤5：修复Homebrew Python的pip关联异常 #

如果你的系统Python是通过Homebrew安装的3.13.2，可能存在pip关联问题，执行以下命令重置：

brew reinstall python@3.13

之后重新创建虚拟环境并安装ipykernel：

python3 -m venv .venv
source .venv/bin/activate
pip install ipykernel

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