故障排除

如果您遇到此处未列出的问题，您可以通过 Anaconda 社区获得对 Anaconda 的支持。有关 Anaconda 安装或技术支持选项，请访问我们的支持产品页面。

注意

Navigator 和 Anaconda.org 故障排除页面已合并到此页面中。点击查看其部分：

• Navigator

• Anaconda.org

提示

您可以使用浏览器的搜索功能在此页面中搜索信息：Ctrl+F （Windows）/Cmd+F （Mac）。

最常见的问题

Conda：通道不可用/缺失或包本身缺失

原因

配置.condarc在 Pro（旧版）或 Business 层上，在某些情况下，您可能无法安装包。 您可能会收到一条错误消息，指出通道或包不可用或缺失。

解决方案

所有这些问题的一个可能解决方法是运行以下命令：

conda clean --index-cache

这将清除“索引缓存”并强制 conda 从存储库服务器同步元数据。

从 Anaconda 通道收到 403 错误

提示

如果您正在使用 Anaconda 托管的conda-forge并收到 403 错误，请参阅从托管 conda-forge 接收 403 错误。

原因

403 错误是 Web 服务器在禁止客户端访问资源时发出的一般 HTTP 错误。换句话说，如果您收到 403 错误，conda 会认为该通道不存在，或者您没有使用它的权限。

您收到的 403 错误可能如下所示：

Collecting package metadata (current_repodata.json): failed

UnavailableInvalidChannel: HTTP 403 FORBIDDEN for channel main <https://repo.anaconda.com/repo/main>

The channel is not accessible or is invalid.

You will need to adjust your conda configuration to proceed.
Use `conda config --show channels` to view your configuration's current state,
and use `conda config --show-sources` to view config file locations.

收到此错误的可能原因有以下几种：

• 您在.condarc文件。

• 防火墙或其他安全设备或系统阻止用户访问。

• 由于可能违反服务条款，访问被阻止。

解决方案

首先，仔细检查您的通道配置并验证是否已正确输入地址。

如果失败，请与您的 IT 管理员联系，以确保您的代理或防火墙不会阻止流向存储库通道的流量。

如果您确定流量未被阻止并且您的问题仍然存在，请打开支持票证。

HTTP 000 连接失败

原因

这通常是由代理配置错误引起的，可以通过正确设置代理服务器来纠正。但是，由于某些企业没有提供 SSL 证书的简单方法，因此 Anaconda 建议您在遇到此错误时绕过 SSL 验证步骤。

解决方案

如果您收到此错误消息，请首先运行以下命令：

conda config --set ssl_verify false

（Package Security Manager 用户）如有必要，安装conda-token通过运行以下命令：

conda install conda-token --channel https://repo.anaconda.cloud/repo/anaconda-tools --name base

（Package Security Manager 用户）通过运行以下命令，确保Token验证步骤忽略 SSL 错误：

# Replace <TOKEN> with your token
conda token set --no-ssl-verify <TOKEN>

您可能会看到以下警告，但您可以放心地忽略它：

/Users/<USERNAME>/Applications/miniconda3/lib/python3.7/site-packages/urllib3/connectionpool.py:1020: InsecureRequestWarning: Unverified HTTPS request is being made to host 'repo.anaconda.cloud'. Adding certificate verification is strongly advised. See: https://urllib3.readthedocs.io/en/latest/advanced-usage.html#ssl-warnings
InsecureRequestWarning,

Conda：在 macOS/Linux 上找不到命令

原因

conda shell 函数不可用或无法正常工作。一些原因可能包括：

• 安装 Anaconda 或 Miniconda 后您没有重新启动 shell。

• 您不允许安装程序修改您的启动脚本。

• Conda 已损坏，通常是由于 Python 包中的更改（例如 3.9->3.7）。

• 您已设置auto_activate_base自false.

解决方案

如果您的安装是新的，请关闭并重新打开您的终端应用程序。如果您希望您的终端保持打开状态，您可以采购~/.zshrcfile（在 macOS 中）或~/.bashrc文件（在 Linux 中）。当您 “source” 脚本时，您的终端会重新读取它并应用更改，这通常只发生在终端首次打开时。

MacOS

source ~/.zshrc

Linux

source ~/.bashrc

—

要在当前终端中初始化 conda，请运行以下命令，具体取决于您的作系统：

MacOS

# Replace <PATH-TO-CONDA> with the file path to your conda installation
<PATH-TO-CONDA>/bin/conda init zsh

例如，如果您将 Anaconda Distribution 安装到默认位置，并且.sh安装程序 （~/anaconda3/），您的命令将如下所示：

~/anaconda3/bin/conda init zsh

Linux

# Replace <PATH-TO-CONDA> with the file path to your conda installation
<PATH-TO-CONDA>/bin/conda init bash

例如，如果您将 Anaconda Distribution 安装到默认位置，则您的命令将如下所示：

~/anaconda3/bin/conda init bash

—

要查看auto_activate_base，请执行以下命令。

conda config --describe auto_activate_base

如果您的终端返回true，这意味着 Conda 不会在您启动新 shell 时自动激活您的基本环境。此行为模拟您的系统 Python，一些用户更喜欢让他们的 conda 环境处于非活动状态，直到他们需要它。但是，这不是 conda 在安装后的默认行为。

要更改auto_activate_base，请执行以下命令。

# Replace <TRUE_OR_FALSE> with true or false
conda config --set auto_activate_base <TRUE_OR_FALSE>

如果你有auto_activate_base设置为false，conda 命令仍将作为 shell 函数提供，但在启动新 shell 时，您的基本环境将不会处于活动状态。要激活基本环境，请运行conda activate.

conda update anaconda命令不会安装最新版本的anaconda元包

注意

这anaconda元包已于 2023 年 2 月从 Anaconda Distribution 安装程序中删除，并且不再出现在您的baseenvironment 中。本疑难解答主题假定您在包含anacondametapackage 中。

原因

如果您安装的软件包与 Anaconda 元软件包的最新版本不兼容，则运行conda update anaconda将 Anaconda 元包更新到最新的兼容版本。请记住，这可能不是最新版本。

解决方案

1. 通过运行conda update anaconda或conda install anaconda=2023.07.

   注意

   取代2023.07替换为最新版本号。

2. 进入n以取消安装或更新。

3. 知道哪些软件包存在冲突后，您可以：

   • 更新所有当前软件包，而不升级到最新版本的anacondametapackage 或

   • 删除冲突的软件包，然后升级到最新版本的anacondametapackage 中。

—

要更新所有当前软件包而不升级到最新版本的anacondametapackage 中：

1. 删除anacondametapackage 本身：

   conda remove anaconda
   

2. 通过运行以下命令更新所有当前安装的软件包：

   conda update --all
   

—

要删除冲突的软件包并升级到最新版本的anacondametapackage 中：

1. 通过对每个包运行以下命令来删除冲突的包：

   conda remove <PACKAGE>
   

2. 更新到最新版本的anacondametapackage 中：

   conda update anaconda
   

恢复 Anaconda 安装

如果您的 Anaconda 安装已损坏并处于正常 conda 命令无法运行的状态，请使用以下步骤修复 Anaconda 并保留已安装的软件包和环境。

解决方案

1. 下载新的安装程序，然后按照适用于您的作系统的说明进行作。

   注意

   使用安装的实际路径、文件名和目录名称。

   Windows

   1. 打开终端应用程序，例如 Command Prompt。

   2. 更改原始安装程序的名称，以免覆盖它：

      move anaconda3 anaconda_old
      

   3. 像往常一样运行 Anaconda.exe 安装程序，并使用 robocopy 同步目录：

      robocopy anaconda_old anaconda3 /S
      

   4. 删除旧的 Anaconda 安装目录：

      rd /s anaconda_old
      

   MacOS

   1. 打开终端应用程序。

   2. 更改原始安装程序的名称，以免覆盖它：

      mv anaconda3 anaconda_old
      

   3. 安装到与原始安装程序相同的目录：

      # Replace <INSTALLER> the name of your installer file
      bash ~/Downloads/<INSTALLER>
      rsync -a anaconda_old/ anaconda3/
      

   4. 删除旧的 Anaconda 安装目录：

      rm -rf anaconda_old
      

   Linux

   1. 打开终端应用程序。

   2. 更改原始安装程序的名称，以免覆盖它：

      mv anaconda3 anaconda_old
      

   3. 安装到与原始安装程序相同的目录：

      # Replace <INSTALLER> the name of your installer file
      bash ~/Downloads/<INSTALLER>
      rsync -a anaconda_old/ anaconda3/
      

   4. 删除旧的 Anaconda 安装目录：

      rm -rf anaconda_old
      

2. 跑conda list以查看以前安装的软件包。

3. 跑conda info -e列出在先前安装中创建的环境，这些环境现在在新安装中可用。

Anaconda 分发问题

在防火墙或代理后面使用 Anaconda

公司安全策略可能会阻止新的 Anaconda 安装下载需要连接到外部服务器的包和其他功能。要建立外部连接，您可能需要连接到防火墙/代理。此外，您的 IT 团队可能需要允许连接到 https://anaconda.org 和 https://repo.anaconda.com，因为这些是主要的软件包存储库。

解决方案

要添加代理信息，您需要将两个条目添加到.condarc文件，位于用户的主目录中。此信息应由您的 IT 团队提供，并且可能包含 URL 中包含的用户名和密码。有关更多信息，请参阅配置 conda 以便在代理服务器后使用。

例.condarc文件配置：

channels:
  - defaults

proxy_servers:
  http: http://username:[email protected]:8080
  https: https://username:[email protected]:8443

在某些情况下，可能需要导出HTTP_PROXY和HTTPS_PROXY环境变量。

Windows

set HTTP_PROXY=http://username:[email protected]:8080
set HTTPS_PROXY=https://username:[email protected]:8443

macOS/Linux

export HTTP_PROXY=http://username:[email protected]:8080
export HTTPS_PROXY=https://username:[email protected]:8443

如果这些步骤不允许连接，您应该与您的 IT 团队联系，以验证安全策略是否未阻止与 https://anaconda.com 或 https://repo.continuum.io 的连接。

InsecurePlatformWarning 错误

原因

InsecurePlatformWarning仅当安装的 Python 版本低于版本 2.7.9 时，才会显示。此消息仅警告未验证 SSL 连接的有效性。它应该不会影响您的包下载。

解决方案

要解决此问题，请安装更新的软件包ndg-httpsclient:

conda install ndg-httpsclient

注意

最初安装此软件包时，您会再次收到 SSL 警告。安装后，该软件包将阻止警告。

Anaconda 搜索错误：无法识别为内部或外部命令/无法识别的参数

原因

如果anaconda-client未安装，并且您使用 Anaconda 搜索命令在 anaconda.org 上搜索软件包...

# Replace <PACKAGE> with the name of a package you want to search for
anaconda search --package-type conda <PACKAGE>

…您将收到以下错误消息：

Windows

'anaconda' is not recognized as an internal or external command,
operable program or batch file.

macOS/Linux

usage: conda [-h] [-V] command ...
conda: error: unrecognized arguments: -t <PACKAGE>

解决方案

要解决此错误，请执行以下作：

1. 安装anaconda-client通过运行以下命令：

   conda install anaconda-client
   

2. 搜索包：

   # Replace <PACKAGE> with the name of the package you are looking for
   anaconda search --package-type conda <PACKAGE>
   

正在收集包元数据 （repodata.json）：- 已终止

原因

在安装或搜索软件包时，您可能会看到进程突然结束，并显示 “Killed” 消息：

$ conda install numpy
Collecting package metadata (current_repodata.json): done
Solving environment: failed with initial frozen solve. Retrying with flexible solve.
Collecting package metadata (repodata.json): - Killed

这可能是因为您的系统没有足够的磁盘空间或内存来完成该过程。

解决方案

验证您的系统上是否有足够的磁盘空间和内存来安装和使用 Anaconda 软件包。Miniconda 和 Anaconda 安装程序的最低系统要求可以在conda 用户指南。

使用 gcc 编译 Python 扩展时的链接问题

原因

在 Windows 上使用 gcc 编译 Python 扩展时，可能会导致链接问题。

解决方案

要解决这些链接问题，请使用 conda 软件包libpython，一个 Anaconda 构建并包含在 Anaconda 发行版中的 mingw 导入库。

错误消息：无法删除文件

尝试使用 conda 更新或安装软件包时，您可能会看到一条错误消息，例如：

Error: Unable to remove files for package: <PACKAGE>
Please close all processes running code from conda and try again.

原因

通常，这是由文件锁定问题引起的。

解决方案

在使用 conda 更新或安装任何包之前，请务必终止任何正在运行的 Anaconda 进程，例如 Navigator、Spyder 或 IPython。

您还可以强制安装软件包：

# Replace <PACKAGE> with the name of the package you want to install
conda install --force-reinstall <PACKAGE>

使用 32 位和 64 位库和 CONDA_FORCE_32BIT

要使用 32 位和 64 位库，Anaconda 建议您进行两个单独的安装：Anaconda32 和 Anaconda64 或 Miniconda32 和 Miniconda64。

解决方案

使用这两个版本时，请将安装程序文件的路径添加到 PATH。

要获取有关 conda 的信息（包括您的 PATH），请运行以下命令：

conda info -a

谨慎

• 请始终指定要使用的版本，因为混合使用 32 位和 64 位软件包可能会导致您的环境中出现问题。

• 用force_32bit不建议这样做，因为它会强制在环境中安装 32 位软件包，但不会强制在运行时加载 32 位库。

• force_32bit应仅在运行时使用conda-build在 64 位系统上构建 32 位软件包。

Anaconda Distribution 安装问题

安装后无法运行 conda

在 macOS 或 Linux 中，您可能会收到“conda not found”或“conda is not recognized as an internal or external command”或类似消息，并且无论您在哪个路径上，都无法在终端窗口中执行 conda。如果您使用 Anaconda Prompt 终端对话框，则不会在 Windows 中发生这种情况。

原因

在安装 Anaconda 或 Miniconda 时，您很可能对有关在 PATH 中加上 conda 提示符的问题回答“否”。

解决方案一

卸载并重新安装 Anaconda 或 Miniconda，对有关在 conda 提示符前加上的问题回答“是”。

解决方案二

MacOS

手动编辑.bash_profile文件以在 Anaconda 或 Miniconda 安装位置之前添加。

1. 打开.bash_profile文件：

   open ~/.bash_profile
   

2. 将此行添加到.bash_profile文件并保存：

   # Replace <USERNAME> with your username
   export PATH=/Users/<USERNAME>/anaconda3/bin:$PATH
   

3. 关闭并重新打开终端窗口，然后再次运行 conda 命令。

Linux

手动编辑.bashrc文件以在 Anaconda 或 Miniconda 安装位置之前添加。

1. 打开.bashrc文件：

   open ~/.bashrc
   

2. 将此行添加到.bashrc文件并保存：

   # Replace <USERNAME> with your username
   export PATH=/Users/<USERNAME>/anaconda3/bin:$PATH
   

3. 关闭并重新打开终端窗口，然后再次运行 conda 命令。

在 OSX 上运行 .pkg 安装程序时出现“此软件包与此版本的 macOS 不兼容”错误

运行.pkg安装程序，您可能会在 “Installation” 步骤中遇到以下错误：

原因

当安装尝试写入没有写入权限的目录时，会发生此错误。

解决方案

手动选择适当的安装位置。以下示例说明如何选择用户的主目录。

1. 重新运行安装程序并单击，直到到达 Installation Type 或 Destination Select 页面。

2. 如果您首先到达 Installation Type 页面，请单击 Change Install Location...。这将带您进入 Destination Select 页面。

   

3. 单击 Install on a specific disk...。

4. 选择适当的目标驱动器。然后单击 Choose Folder...。

   

5. 选择用户的主目录（例如 /Users/john.doe/）。然后单击 Choose。

6. 在消息框中，确认您在上一步中选择的安装文件夹的名称。然后单击 Continue （继续）。

   

7. 单击 Install（安装），然后继续进行其余的安装。

如果您继续收到相同的错误消息，请在此处打开一个 issue，并确保包含install.log文件，可在/var/log/install.log.

Anaconda 安装程序下载问题

原因

Anaconda 安装程序文件很大（超过 600 MB），一些用户在下载大文件时遇到错误和下载中断的问题。

解决方案一

1. 下载并安装较小的 Miniconda（70 到 100 MB 之间）。

2. 使用以下命令下载并安装 Anaconda 中的其余软件包：

   conda install anaconda
   

注意

如果包下载中断，只需运行conda install anaconda再。Conda 仅下载在之前的任何尝试中未完成的包。

解决方案二

下载大型 Anaconda 安装程序文件，如果下载中断或您需要暂停下载，请重新启动它。

Windows

铬

1. 在 anaconda.com 中找到最新的安装程序，或在 repo.anaconda.com/archive 找到较早的安装程序。

2. 在 Chrome 中，使用 Ctrl+J 打开 Chrome 下载管理器。

3. 单击 Resume 继续中断的下载。

Chrome 下载管理器还允许您暂停和恢复或取消并重试正在进行的下载。

边缘

1. 在 anaconda.com 中找到最新的安装程序，或在 repo.anaconda.com/archive 找到较早的安装程序。

2. 在 Edge 中，单击 设置 及更多。

3. 单击 Downloads 以打开 Downloads 对话框。

4. 在这里，您可以使用 play、pause 和 cancel 按钮来控制正在进行的下载。

提示

转到 edge://downloads/all 以打开最近下载的完整页面。在这里，您可以重试已取消的下载。

IE浏览器

1. 在 anaconda.com 中找到最新的安装程序，或在 repo.anaconda.com/archive 找到较早的安装程序。

2. 单击 Tools（工具）。

3. 单击 View Downloads 以打开 Download Manager。

4. 点击 继续 在停止的下载旁边重新开始下载。下载将在停止的位置继续。

macOS 和 Linux

1. 打开终端窗口。

2. 要下载文件，请使用以下命令：

   # Replace <INSTALLER> with the the installer file you want to install
   # See all available installers on https:://repo.anaconda.com/archive/
   curl -O https://repo.anaconda.com/archive/<INSTALLER>
   

3. 要暂停下载，请使用 Ctrl+C。

   注意

   暂停下载时，您可以关闭或重新启动计算机。

4. 当您准备好恢复下载时，请使用以下命令：

   #Replace <INSTALLER> with the same file you used above
   curl -O -C https://repo.anaconda.com/archive/<INSTALLER>
   

   注意

   这-Cflag 是 “continue” 的选项。您可以根据需要多次暂停和重新开始下载。

Miniconda 安装错误消息：已安装

原因

如果您收到 conda 错误并且想要重新安装 Miniconda 来修复它，则可能会出现这种情况。

解决方案

对于 macOS 和 Linux，请使用 Miniconda 下载页面下载并安装适合您的作系统的 Miniconda--force或-f选项：

# Replace the name of the installer if you need a different version or operating system
bash ~/Downloads/Miniconda3-latest-MacOSX-x86_64.sh -f

谨慎

确保安装到与现有安装相同的位置，以便它覆盖核心 conda 文件，并且不会在新文件夹中安装重复项。

在 OSX 上运行 .pkg 安装程序时出现“安装失败”消息

原因

运行.pkg安装程序，您可能会在安装结束时看到以下消息：

如果是这样，请检查以下内容：

1. 打开/var/log/install.log文件，并检查最近的行在调用conda init --all.

   open /var/log/install.log
   

2. 在您的$HOME目录中，请检查 shell 配置文件的所有者是否为root:

   ls -la ~/.bash_profile ~/.config/fish/config.fish ~/.tcshrc ~/.xonshrc ~/.zshrc
   

   

解决方案

如果上述两个情况都成立，请执行以下作：

1. 将 shell 配置文件的所有者更改为当前用户：

   sudo chown -R $USER ~/.bash_profile ~/.config/fish/config.fish ~/.tcshrc ~/.xonshrc ~/.zshrc
   

   

2. 卸载以前的安装。然后重新运行安装程序，确保选择 Install only for me （仅为我安装） 选项。

特定于 Windows 的 Anaconda 分发问题

在 Windows 上安装后看不到 Anaconda 菜单快捷方式

在 Windows 上安装后，Anaconda Prompt 和 Anaconda Navigator 快捷方式不会出现在 Windows 开始菜单中。

原因

这可能是由于 Windows 更新“开始”菜单的方式，或者由于安装了多个相互干扰的 Python 版本造成的。现有的 Python 安装、在全球位置安装 Python 模块或与 Anaconda 库同名的库都可能阻止 Anaconda 正常工作。

解决方案

如果缺少“开始”菜单快捷方式，Microsoft 建议重新启动计算机或重新启动 Windows 资源管理器。

如果这不起作用，请清除$PYTHONPATH环境变量（如果适用），然后重新安装 Anaconda。

以下博客文章的“与系统状态冲突”部分介绍了其他可能的解决方案。

Windows 错误：无法创建 Anaconda 菜单或无法将 Anaconda 添加到系统 PATH

在 Windows 系统上安装期间，会出现一个对话框，显示“无法创建 Anaconda 菜单，中止重试忽略”或“无法将 Anaconda 添加到系统 PATH”。造成这种情况的 Windows 可能的原因有很多。

解决方案

按顺序尝试以下解决方案：

• 不要安装在长度超过 1024 个字符的 PATH 上。

• 在安装之前关闭防病毒程序，然后重新打开防病毒程序。

• 卸载所有以前的 Python 安装。

• 清除文件中所有与 Python 相关的 sysdm.cpl PATH。

• 删除以前设置的任何 Java PATH。

• 如果已安装 JDK，请卸载它。

注意

要查找 path 变量，请执行以下作：

1. 在任务栏的搜索中搜索“环境变量”。

2. 在侧边栏中选择 Edit the System Environment Variables。

3. 单击 System Properties 对话框中的 Environment Variables。

4. 突出显示用户的 path 变量。

5. 单击 Edit（编辑）。

Anaconda 干扰 Windows 上的其他软件

原因

如果用户选择将 Anaconda 添加到 Windows PATH，这可能会导致程序使用新的 Anaconda 软件版本（如 Python），而不是已经存在的版本。在某些情况下，这可能会导致不兼容和错误。

解决方案

Anaconda 建议不要手动将 Anaconda 添加到 Windows PATH。相反，通过从开始菜单打开 Anaconda Navigator 或 Anaconda Prompt 来使用 Anaconda 软件。

在 Windows 上卸载 Anaconda 后留下的文件

原因

一些用户可能需要保留设置文件，而其他用户可能需要删除它们，因此 Anaconda 在卸载时会保留一些设置文件。具体来说，目录.spyder2,.ipython,.matplotlib和.astropy保持。根据您的 Windows 版本，这些可能位于C:\Documents and Settings\<USERNAME>或C:\Users\<USERNAME>.

注意

取代<USERNAME>替换为您的 Windows 用户名，如Documents and Settings或Users文件夹。

解决方案

手动删除任何不需要的设置文件。

Spyder 错误或在 Windows 上启动失败

原因

这可能是由 Spyder 设置和配置文件中的错误引起的。

解决方案

1. 关闭并重新启动 Spyder，看看问题是否仍然存在。

2. 打开开始菜单，然后单击重置 Spyder 设置，看看问题是否仍然存在。

3. 关闭 Spyder 并使用以下命令从 Anaconda Prompt 重新启动它：

   spyder
   

4. 删除目录.spyder2，然后重复此列表中的第一项。根据您的 Windows 版本，.spyder2可能在C:\Documents and Settings\<USERNAME>或C:\Users\<USERNAME>.

注意

取代<USERNAME>替换为您的 Windows 用户名，如Documents and Settings或Users文件夹。

卸载程序在 Windows 上请求管理员权限

在 Windows 上以非管理员用户身份安装 Anaconda 或 Miniconda 后，卸载可能会提示输入管理权限。

原因

通过选择控制面板>卸载程序，从程序列表中选择 Anaconda 或 Miniconda，然后单击卸载来运行卸载程序时，会发生这种情况。

解决方案

打开anaconda3或miniconda3安装文件夹并运行.exefile uninstaller 从该位置卸载。卸载将完成，而不会提示输入管理权限。

示例：如果您安装了 Miniconda3，则卸载文件将为Uninstall-Miniconda3.exe.安装 Miniconda2 或 Anaconda 的用户将找到具有适当名称的类似文件。

从 Favorites 文件夹安装时出现 Windows 权限错误

原因

Windows 收藏夹文件夹具有异常权限，可能会导致任何软件的安装程序出现权限错误。如果您尝试从 Favorites 文件夹启动安装程序，您可能会看到诸如“安装程序无法创建目录”、“访问被拒绝”或“打开文件进行写入时出错”等错误。

解决方案

将安装程序移动到其他文件夹，然后从新文件夹运行安装程序。

在 Windows 上的 PowerShell 上激活时出现问题

某些用户在 Windows 上可能会遇到以下回溯：

File "C:\Users\damia\Miniconda3\lib\site-packages\conda\activate.py", line 550, in _replace_prefix_in_path
assert last_idx is not None
AssertionError

解决方案

1. 打开 Command Prompt 窗口。

2. 导航到安装 conda 的位置。以下命令显示默认值：

   cd C:\Users\<USERNAME>
   

3. 运行以下命令：

   python -m conda init
   

4. 关闭 Command Prompt 窗口。

注意

如果上述方法不起作用，请尝试运行：

conda update conda

特定于 MacOS Anaconda 分发问题

zsh shell 中的“Conda： command not found”

原因

如果您在 macOS 计算机上安装 conda 时没有初始化它，或者如果您卸载并重新安装了 zsh（或删除了.zshrc文件），您的 zsh shell 将无法正确使用 conda 命令。

解决方案

要为 zsh 初始化 conda，请执行以下作：

1. 打开终端应用程序并运行以下命令：

   # Replace <PATH-TO-CONDA> with the file path to your conda installation
   <PATH-TO-CONDA>/bin/conda init zsh
   

   例如，如果您将 Miniconda 安装到默认位置，并且.sh安装程序 （~/miniconda3/），则命令将为：

   ~/miniconda3/bin/conda init zsh
   

2. 关闭并重新打开您的终端应用程序。

使用 macOS Python 3.7 解释器导入包时出现分段错误

在 CPython < 3.8 中，使用python3-config确定用于编译扩展模块的链接命令行将导致该扩展模块在导入时出现段错误。python3-config确实提供了命令行标志，但用于嵌入 Python 解释器的不同目的。

原因

这是因为python3-config.在 Python 3.8 之前，需要这些组件才能将核心 Python 解释器完全嵌入到不同的项目中，而不是在链接 Python 扩展模块时应该使用的那些。

Python 模块绝不应直接链接到核心 Python 解释器库，无论是在构建时静态链接，还是在运行时动态链接。这是因为 Python 可执行文件本身提供了所有必要的函数和符号。

解决方案

您应该只使用python*-config —ldflags当链接到解释器库（静态或共享）时。

Action	Python < 3.8	Python >= 3.8
Get command line to link to extension module	python -c "import sysconfig; print(sysconfig.get_config_var('LDSHARED'))"	python3-config --ldflags
Get command line to embed Python interpreter	python3-config --ldflags	python3-config --ldflags --embed

python3-config不包含 command/compiler name，而 sysconfig 方式包含。只要你的参数都没有空格，这就有效了：

python -c "import sysconfig; print(' '.join(sysconfig.get_config_var('LDSHARED').split(' ')[1:]))"

特定于 Linux 的 Anaconda 分发问题

Power8 上缺少 libgomp

如果 Python 命令import numpy失败，则系统可能缺少libgompsystem 库。

原因

大多数 Power8 Linux 发行版包括libgomp，但有些可能不是。

解决方案

检查系统是否缺失libgomp通过运行以下命令：

conda inspect linkages --name root numpy

如果libgomp.so.1列在not found:部分，则必须安装它。

安装libgomp在 Ubuntu 上运行以下命令：

apt install libgomp1

安装libgomp在 Red Hat Enterprise Linux （RHEL） 或 CentOS 上运行以下命令：

yum install libgomp

Power8 上的 Anaconda 报告“无法执行二进制文件”

原因

Power8 上的 Anaconda 仅支持 little endian 模式。小端 Python 二进制文件不会在 big endian作系统上执行。

解决方案

在 Power8 上安装 Anaconda 在 little endian Linux 安装或 VM 上。

Anaconda Distribution 安装失败，出现“'ascii' 编解码器无法在位置 96 编码字符 'xe4'”错误

原因

包装conda-package-streaming需要某些编码变量，而 Linux 的新安装可能没有正确设置这些变量，从而导致 ASCII 错误和 Anaconda Distribution 安装失败。

解决方案

1. 将以下内容添加到当前的 shell 配置文件 （.bashrc,.zshrc等）：

   export LANGUAGE="en_US.utf8"
   export LC_ALL="en_US.utf8"
   export LC_CTYPE="en_US.utf8"
   export LANG="en_US.utf8"
   

2. 如果您的安装程序在失败之前部分运行，则您的安装目录可能不为空。如果是这样，请删除您的安装目录。

3. 重新运行安装程序。

导引问题

Navigator 无法更新到版本 2.6.4

原因

如果您使用的是 Navigator 版本 2.6.3 并且无法更新到版本 2.6.4，则可能是由于anaconda-navigatorpackage 和anaconda-toolbox包。（每个软件包都列出了anaconda-cloud-auth作为依赖项。

解决方案

要检查您是否具有anaconda-toolbox包中，打开 Anaconda Prompt（macOS/Linux 上的终端）并运行以下命令：

conda list anaconda-toolbox

要解决anaconda-navigator和anaconda-toolbox:

1. 关闭 Navigator（如果打开）。

2. 打开 Anaconda Prompt（macOS/Linux 上的终端）。

3. 运行以下命令：

   conda install --name base anaconda-navigator=2.6.4 anaconda-toolbox=4.1.0
   

4. 进入y以批准包更改。

   提示

   更新基本环境后，可以安全地关闭 Anaconda Prompt/Terminal。

5. 重新打开 Navigator。

解决此依赖关系冲突后，可以照常完成对 Navigator 的任何未来更新。请参阅更新 Navigator。

启动时出现 Navigator 错误

原因

这通常是.condarc文件。

解决方案

要解决此问题，请删除.condarc文件并重新启动 Navigator。

1. 查找.condarc文件。

   打开 Anaconda Prompt（macOS/Linux 上的终端）并输入命令conda info.输出将告诉您.condarc文件。您也可以在计算机上搜索 “.condarc”。

   这.condarc文件常见于：

   • macOS 版本：/Users/<USERNAME>

   • Linux的：~/.condarc

   • Windows：C:\\Users\\<USERNAME>

2. 可选：保存自定义配置。

   如果您的.condarc文件，请保存信息以将该配置添加回新文件。

3. 删除.condarc文件。

4. 重新启动 Navigator。

启动或初始化问题

原因

启动或初始化 Anaconda Navigator 的问题可能是由权限或许可问题引起的。

解决方案

• 如果您无法通过其桌面或应用程序快捷方式启动 Anaconda Navigator 桌面应用程序，您仍然可以通过 Anaconda Prompt（macOS/Linux 上的终端）启动它。输入以下命令：

  anaconda-navigator
  

• 如果您有权限问题，则可能是隐藏的许可证目录有问题。.continuum.要删除.continuum目录中，打开 Anaconda Prompt（macOS/Linux 上的终端）并运行以下命令，具体取决于您的作系统：

  Windows

  rd /s .continuum
  

  macOS/Linux

  rm -rf ~/.continuum
  

  然后，从桌面应用程序或 Anaconda Prompt（macOS/Linux 上的终端）重新启动 Navigator。

• 如果删除 licenses 目录无法解决问题，请通过打开 Anaconda Prompt（macOS/Linux 上的终端）并运行以下命令来手动更新 Navigator：

  conda update --name base anaconda-navigator
  

• 如果您更新了 Navigator 但仍有问题，请通过打开 Anaconda Prompt（macOS/Linux 上的终端）并运行以下命令来删除并重新安装 Anaconda Navigator：

  conda remove --name base anaconda-navigator
  conda install --name base anaconda-navigator
  

• 如果上述方法均无效，请通过打开 Anaconda Prompt（macOS/Linux 上的终端）并运行以下命令，将 Anaconda Navigator 配置重置回默认值：

  anaconda-navigator --reset
  

macOS Catalina 上的 PermissionError

原因

macOS Catalina 用户可能会遇到权限错误，即系统不会提示您对需要访问的文件夹的权限。

解决方案

1. 通过打开 Anaconda Prompt（macOS/Linux 上的终端）并运行以下命令来更新 Navigator：

   conda update --name base anaconda-navigator
   

2. 更新后，让 Navigator 通过启动 Spyder 并在控制台中运行以下命令来生成权限提示：

   # Replace <DIRECTORY> with the folder you need access to
   import os
   os.listdir('<DIRECTORY>')
   

Access denied 错误

原因

这是由锁定文件引起的，该文件有时会卡住并且没有在应该删除的时候删除。

解决方案

打开 Anaconda Prompt（macOS/Linux 上的终端）并通过运行以下命令删除锁定文件：

conda update --name base conda anaconda-navigator navigator-updater
anaconda-navigator --reset

缺少导引按钮

原因

Navigator 按钮的消失可能是由于不同步的 repodata、损坏的.condarc文件或未知问题。

解决方案

1. 从 Navigator 的 Environments （运行环境） 页面运行 Update Index。

2. 退出并重新启动 Navigator。

如果该解决方案不起作用，请尝试以下作之一：

• 确认您的.condarc文件未损坏。请特别确认您的频道设置包含defaults.

• 打开 Anaconda Prompt（macOS/Linux 上的终端）并运行以下命令：

  conda search python
  

  这将下载 repodata 的新副本，这应该可以解决问题。

• 如果上述选项均无效，请打开一个 issue 来详细说明错误。

在 Navigator 中登录到 Anaconda Server 连接时出现问题

如果您在登录时遇到问题或知道自己已登录但无法与 Anaconda Server 交互，请尝试以下解决方案：

解决方案

1. 设置logged_api_url,anaconda_server_token和anaconda_server_token_id在 Navigator 配置文件 （anaconda-navigator.ini） 设置为 None。

   注意

   Token和Token ID 配置变量名称已从team_edition_token自anaconda_server_token和team _edition_token_id自anaconda_server_token_id从版本 2.4.0 开始。如果您将 Navigator 应用程序降级到低于 2.3.0 的版本，则需要在anaconda-navigator.ini文件。

2. 从 conda 配置文件中删除 channel_alias （.condarc).

3. 请再次尝试登录。

VS Code 未显示在 Navigator Home 选项卡上

第

Anaconda Navigator 通过该应用程序的可执行文件显示和启动 VS Code 和许多其他应用程序。VS Code 的安装应该将可执行文件放在 Navigator 编程查找的特定目录中。例如：

• Windows 仅限用户安装：C:\\Users\\User\\AppData\\Local\\Programs\\Microsoft VS Code

• Windows 系统范围的安装：C:\\Program Files\\Microsoft VS Code

• Linux-64 的：/usr/share/code

• macOS 版本：/Applications

解决方案

有两种方法可以解决此问题：

• 重新安装 VS Code 以确保可执行文件安装在默认位置。

  1. 关闭 Navigator。

  2. 卸载 （如有必要） 并重新安装 VS Code。

     注意

     在 macOS 上，确保 VS Code 应用程序已从 Downloads 文件夹移动到 Applications 文件夹。

  3. 重新打开 Navigator。

• 如果您已将 VS Code 安装到与默认位置不同的位置，请在 Navigator 用户首选项中编辑 VS Code 的路径。

  1. 从顶部菜单栏中打开 Anaconda Navigator 首选项对话框（例如 File > Preferences 或 Anaconda Navigator > Preferences）。

  2. 向下滚动到 VS Code 路径设置。

  3. 输入您希望 Anaconda Navigator 使用的 VS Code 安装路径。这可能类似于上面的示例，特别是如果您有一个特定于用户的安装，您更愿意使用而不是系统范围的安装。

     注意

     您无需输入可执行文件本身的名称。只是包含该文件的文件夹的路径。

  4. 关闭并重新打开 Navigator。

Anaconda Navigator 无法启动并给出 Permission denied 错误

安装后，Anaconda Navigator 可能无法启动，并在 anaconda-client 配置文件（/.continuum/anaconda-client/config.yaml).

原因

此错误可能是由于anaconda-client正在使用管理员权限进行安装。这将导致anaconda-clientconfig 文件。

解决方案

您可以采取一些措施来解决此问题。它们按从最简单到最复杂的顺序列出。

删除 .continuum 文件夹

1. 备份您的.config.yaml文件复制到其他位置。

2. 删除.continuum文件夹。

3. 再次启动 Navigator。

4. 复制您保存的.config.yaml文件放回/.continuum/anaconda-client.

在没有管理员权限的情况下卸载并重新安装

卸载 Anaconda，然后在没有管理员权限的情况下重新安装 Anaconda。

手动更改 .continuum 文件夹的用户权限

您需要管理员权限才能执行此作。

Windows

1. 搜索 “powershell”。

2. 右键单击 Windows PowerShell 应用程序，然后选择 Run as administrator（以管理员身份运行）。

3. 运行以下命令：

   #Replace <USERNAME> with your username
   icacls C:\Users\<USERNAME>\.continuum /grant:r <USERNAME>:(i,f) /t
   

macOS/Linux

1. 打开您的终端应用程序。

2. 运行以下命令：

   sudo chmod 766 /.continuum
   

Navigator 显示“电子邮件验证失败”错误 403

原因

拥有未经验证的 Anaconda.org 电子邮件地址的用户无法再访问 Navigator 和 Anaconda Client 用于与 Anaconda.org 通信的 API。Navigator 2.5.0+ 现在会捕获此错误并将您从 Anaconda.org 连接中注销。

解决方案

要通过 Navigator 再次连接到 Anaconda.org，请更新您的 Navigator 版本或验证您的 Anaconda.org 账户。

验证您的 anaconda.org 帐户

要完全解决此问题，我们建议您在 Anaconda.org 上验证您的账户：

1. 登录您的 Anaconda.org 帐户。

2. 如果您的电子邮件未经验证，系统将提示您进行验证。

3. 单击 Resend confirmation email （重新发送确认电子邮件）。

4. 按照您收到的电子邮件中的说明完成验证过程。

Navigator 无法启动，因为“即使找到 Qt 平台插件，也无法在 '” 中加载 qt 平台插件 “xcb” “错误

原因

在 CentOS 7 Linux中，Orange3 缺少 Qt 所需的一些图形库，而 Qt 是 Orange Canvas 工作所需的框架。

这些缺少的依赖项会导致启动 Navigator 时出现错误：“无法在 ”“ 中加载 Qt 平台插件 ”xcb“ ，即使找到它。此应用程序无法启动，因为无法初始化 Qt 平台插件。

解决方案

1. 打开终端应用程序。

2. 通过运行以下命令安装缺少的系统库并运行更新：

   sudo yum install xcb-util-wm xcb-util-image xcb-util-keysyms xcb-util-renderutil
   sudo yum update
   

安装并更新这些库后，Orange3 应该可以在 CentOS 7 上正确启动，并且在打开安装了 Orange3 的 Navigator 时，上述错误应该不会再出现。

禁用 Anaconda Cloud 登录提醒

原因

在 Navigator 版本 2.5.0 及更高版本中，每小时（或从版本 2.6.2 开始每 24 小时出现一次）出现一个对话框，提醒用户登录 Anaconda Cloud（如果他们尚未登录）。这可能会对不想登录 Anaconda Cloud 的用户造成干扰。

解决方案

有几种方法可以禁用 Anaconda Cloud 登录提醒，具体取决于您的 Navigator 版本：

2.6.1 及更高版本

在脱机模式下工作或登录到另一个存储库。

2.5.2 至 2.6.0

1. 打开 Navigator 配置文件。

2. 编辑cloud_login_popup_state成为0在[internal]部分。

   [internal]
   anaconda_toolbox_installed = True
   cloud_login_popup_state = 0
   

2.5.0

1. 打开 Navigator 配置文件。

2. 编辑welcome_state成为0在[internal]部分。

   [internal]
   welcome_state = 0
   

更新弹出窗口未自动显示

原因

如果在登录时没有自动提示您更新 Navigator，可能有多种原因。

• 对话框已被隐藏

• 您的软件包索引不同步

• defaults在您的频道列表中缺失

解决方案

对话框已被隐藏

您可能已在 Update 弹出窗口中单击 Do not show again （不再显示）。如果这是更新弹出窗口无法显示的唯一原因，您仍应在 Connect 旁边看到 Update now （立即更新） 选项。要更新，请单击 Update now（立即更新）。

要让 Update 弹出窗口再次自动显示：

1. 从 File 或 Anaconda Navigator 菜单中打开 Preferences。

2. 取消选择 Hide update dialog on startup（启动时隐藏更新对话框）。

您的软件包索引不同步

如果您的包表未正确更新，则 Navigator 无法识别是否有可用更新。要更新包表，请单击 Environments（环境），然后单击 Update index...（更新索引...）。

您的频道列表中缺少 defaults

没有defaults添加到渠道列表也可能导致 Navigator 的 Update 弹出窗口无法显示。

注意

此问题特别影响未订阅 Premium 存储库的用户。

添加defaults添加到您的频道列表中：

1. 单击 主页 或 运行环境 页面上的 渠道。

2. 单击 Add。

3. 进入defaults，然后按键盘上的 Enter 键 （Windows）/Return 键 （Mac）。

4. 单击 Update channels。

5. 关闭并重新打开 Navigator。

Anaconda.org 问题

尝试在 Firefox 上创建 Anaconda.org 帐户时未显示验证码

Anaconda.org 上的“登录”面板底部的验证码有时无法显示在 Firefox 浏览器上。

原因

验证码可能被广告拦截器扩展、跟踪拦截器扩展或 Firefox 的隐私设置阻止。

解决方案

1. 刷新浏览器，然后重试。如果多次刷新，请在每次刷新之间等待几秒钟。

2. 检查您的扩展。阻止跟踪或广告的扩展也可能阻止验证码。

3. 检查您的浏览器设置。隐私设置可能会阻止验证码。

4. 在专用浏览窗口中打开登录页面。

尝试将笔记本或环境上传到 Anaconda.org 时出现“URI 不再存在并已被永久删除”410 错误

原因

Notebooks 和 Environments 功能已从 Anaconda.org 中删除，作为简化和改进 Anaconda.org 并使站点能够专注于包托管和管理的计划的一部分。因此，笔记本和环境文件无法再上传到 Anaconda.organaconda upload命令。

解决方案

虽然您无法再将笔记本上传到 Anaconda.org，但您可以改用 Anaconda Notebooks 与他人共享您的笔记本。Anaconda Notebooks自带预装环境<../anaconda-notebooks/notebook-environments>，并允许您创建自己的自定义环境。有关使用 Anaconda Notebooks 共享笔记本的更多信息，请参阅共享笔记本。