在Anaconda虚拟环境运行Jupyter Notebook时遭遇ModuleNotFoundError问题

问题背景 #

我用Anaconda创建了名为venv_nlp的Python3.8虚拟环境，执行以下命令安装依赖并配置ipykernel：

conda create --name venv_nlp python=3.8
conda activate venv_nlp
pip install -r requirements.txt
python -m ipykernel install --user --name=venv_nlp

在激活环境的Anaconda提示符里用pip list能看到bertopic包，但切换到Jupyter Notebook的venv_nlp内核后：

• 执行from bertopic import BERTopic提示ModuleNotFoundError，同时弹出ipykernel的弃用警告
• 执行!pip list看不到bertopic包，且代码实际在主Anaconda路径C:\ProgramData\Anaconda3\lib\site-packages下查找依赖，而非虚拟环境路径C:\ProgramData\Anaconda3\envs\virtualenv_nlp

解决步骤 #

1. 确认内核关联的Python路径 #

在Jupyter Notebook中运行以下代码，检查当前内核使用的解释器路径：

import sys
print(sys.executable)

如果输出是主Anaconda路径（C:\ProgramData\Anaconda3\python.exe），说明内核配置有误，需要重新安装。

2. 重新安装虚拟环境内核 #

打开Anaconda提示符，先激活虚拟环境：

conda activate venv_nlp

卸载旧的错误内核配置：

jupyter kernelspec uninstall venv_nlp

重新安装内核，确保关联虚拟环境内的Python解释器：

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

--display-name参数可选，用于在Jupyter中显示更清晰的内核名称。

3. 验证内核关联正确性 #

关闭并重新打开Jupyter Notebook，选择Python (venv_nlp)内核，再次运行路径检查代码：

import sys
print(sys.executable)

此时输出应为虚拟环境的Python路径：C:\ProgramData\Anaconda3\envs\venv_nlp\python.exe

4. 重新确认包安装 #

在激活的虚拟环境中，重新执行依赖安装命令，确保包安装在虚拟环境内：

pip install -r requirements.txt

之后在Jupyter中执行!pip list就能看到bertopic包，运行from bertopic import BERTopic也不会报错。

额外提示（可选） #

尽量避免混用conda和pip安装依赖，减少路径冲突：

• 若依赖包可通过conda安装，执行：

conda install --file requirements.txt

• 必须用pip时，确保在激活虚拟环境后再执行pip命令。

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