Anaconda安装配置Python虚拟环境后使用JupyterNoteBook导入新包失败的解决方法

2024年1月10日 4756点热度 0人点赞 0条评论

今天在使用Python的时候，使用Anaconda创建了一个虚拟环境，在Jupyter Notebook中也激活了这个虚拟环境，而且在这个环境下也安装好了相应的包
但怎么实验，也无法在Jupyter Notebook中成功import新包，报错显示No module xxx found。

实验了各种方法均不成功，后按照下文的方式重新配置一个新的虚拟环境后，再次安装新包成功，特此记录一下方法。

文章的链接和具体内容如下：

在Windows下，为Jupyter创建新的kernel

1.创建环境

打开Anaconda Prompt
输入以下代码创建环境

(D:\Users\seanhe\Anaconda3) C:\Users\seanhe>conda create -n KernelForJupyter python=3.6

得到以下结果

The following NEW packages will be INSTALLED:

    certifi:        2016.2.28-py36_0 https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free
    pip:            9.0.1-py36_1     https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free
    python:         3.6.2-0          https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free
    setuptools:     36.4.0-py36_1    https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free
    vc:             14-0             https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free
    vs2015_runtime: 14.0.25420-0     https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free
    wheel:          0.29.0-py36_0    https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free
    wincertstore:   0.2-py36_0       https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free
Proceed ([y]/n)? y
Linking packages ...
[      COMPLETE      ]|##################################################| 100%
#
# To activate this environment, use:
# > activate KernelForJupyter
#
# To deactivate this environment, use:
# > deactivate KernelForJupyter
#
# * for power-users using bash, you must source
#

2.激活环境以及安装必要的包

输入以下代码激活环境

(D:\Users\seanhe\Anaconda3) C:\Users\seanhe> activate KernelForJupyter

安装 ipykernel

(KernelForJupyter) C:\Users\seanhe>conda install ipykernel

3.创建新的kernel

输入以下代码创建新的kernel

(KernelForJupyter) C:\Users\seanhe>python -m ipykernel install --name NewKernel
Installed kernelspec NewKernel in C:\ProgramData\jupyter\kernels\newkernel

然后就可以在Jupyter中使用了

4.Jupyter其他操作

我们通过以下代码查看juypter kernel的其他命令

(KernelForJupyter) C:\Users\seanhe>jupyter kernelspec --help
Manage Jupyter kernel specifications.
Subcommands
-----------
Subcommands are launched as `jupyter kernelspec cmd [args]`. For information on
using subcommand 'cmd', do: `jupyter kernelspec cmd -h`.
list
    List installed kernel specifications.
install
    Install a kernel specification directory.
uninstall
    Alias for remove
remove
    Remove one or more Jupyter kernelspecs by name.
install-self
    [DEPRECATED] Install the IPython kernel spec directory for this Python
例如我们可以通过以下指令查看当前环境下的kernel

(KernelForJupyter) C:\Users\seanhe>jupyter kernelspec list Available kernels: python3 D:\Users\seanhe\Anaconda3\envs\KernelForJupyter\share\jupyter\kernels\python3 newkernel C:\ProgramData\jupyter\kernels\newkernel

5.作在Anaconda中删除一个环境

方法1：使用Anaconda Prompt（Windows）或终端（macOS/Linux）

打开Anaconda Prompt（Windows）或终端（macOS/Linux）
- Windows：搜索并打开“Anaconda Prompt”（或在开始菜单中找到Anaconda文件夹下的Prompt）。
- macOS/Linux：直接打开终端。
列出所有环境（可选）
确认要删除的环境名称是否正确：
```
conda env list
```
或
```
conda info --envs
```
输出会显示所有环境，当前环境前会标有 *。
删除指定环境
使用以下命令（将 环境名 替换为你要删除的环境名称）：
```
conda env remove --name 环境名
```
或简写：
```
conda remove --name 环境名 --all
```
验证是否删除成功
再次运行 conda env list，确认目标环境已消失。

方法2：通过Anaconda Navigator（图形界面）

打开 Anaconda Navigator（在开始菜单或应用程序中搜索）。
在左侧菜单中点击 “Environments”。
在环境列表中找到要删除的环境，点击其右侧的 **▼ 下拉箭头，选择 “Remove”**。
确认删除操作。

注意事项

删除环境会彻底移除该环境下的所有包和依赖，包括Python解释器，操作不可逆。
如果环境正在使用（如当前激活的环境），需先退出：
```
conda deactivate
```
如果遇到权限问题（如macOS/Linux下提示权限不足），可尝试在命令前加 sudo（不推荐常规使用，优先修复权限问题）。

常见问题

环境名拼写错误：确保输入的环境名与 conda env list 中的完全一致（区分大小写）。
删除失败：如果环境损坏或存在冲突，可以尝试手动删除环境文件夹（路径通常在 ~/anaconda3/envs/环境名 或 ~/miniconda3/envs/环境名），但建议优先使用命令行操作。

完成上述步骤后，目标环境即被彻底删除。

6.在PyCharm 中使用 Anaconda 中新配置的环境

在 PyCharm 中使用 Anaconda 中新配置的环境，如果无法正常使用，通常是由于以下几个原因导致的。以下是详细的排查和解决步骤：

1. 确认环境是否已正确创建

打开 Anaconda Prompt 或终端，运行以下命令查看所有环境：
```
conda env list
```
或
```
conda info --envs
```
确保你创建的环境（如 my_new_env）出现在列表中，并且路径正确。

2. 检查 PyCharm 的 Python 解释器设置

在 PyCharm 中，打开项目后：
1. 点击顶部菜单栏的 File > Settings（Windows/Linux）或 PyCharm > Preferences（macOS）。
2. 进入 Project: <你的项目名> > Python Interpreter。
点击右上角的齿轮图标，选择 Add...（添加解释器）。
在弹出的窗口中：
- 选择 Conda Environment（Conda 环境）。
- 确保勾选了 Existing environment（现有环境），然后在下拉菜单中查找你的环境。
- 如果环境未显示，可以手动指定解释器路径：
  - 点击 **...** 按钮，导航到 Anaconda 安装目录下的 envs/<你的环境名>/bin/python（Linux/macOS）或 envs\<你的环境名>\python.exe（Windows）。

3. PyCharm 未正确识别 Conda 环境

PyCharm 可能未正确关联到 Anaconda 的 Conda 可执行文件。尝试以下操作：
1. 在 Python Interpreter 设置中，选择 Add...。
2. 选择 Conda Environment。
3. 确保 Conda executable（Conda 可执行文件）路径正确：
  - 默认路径可能是：
    - Windows: C:\Users\<用户名>\Anaconda3\Scripts\conda.exe 或 C:\ProgramData\Anaconda3\Scripts\conda.exe。
    - macOS/Linux: ~/anaconda3/bin/conda 或 ~/miniconda3/bin/conda。
  - 如果路径不正确，手动指定 Conda 的安装路径。

4. 环境未激活或 PyCharm 缓存问题

重启 PyCharm：有时 PyCharm 的缓存可能导致环境未及时更新。
在 PyCharm 中尝试 File > Invalidate Caches / Restart（文件 > 使缓存失效并重启），然后重新检查解释器列表。

5. 环境创建在非默认路径

如果你在创建环境时指定了自定义路径（如 conda create --prefix=/path/to/env），PyCharm 可能无法自动检测到它。
在 Python Interpreter 设置中，手动选择该路径下的 python 可执行文件（如 /path/to/env/bin/python）。