故障排除

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

注意

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

• Navigator

• Anaconda.org

提示

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

最常见的问题

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

原因

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

解决方案

一种可能的修复方法是运行以下命令

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 用户）通过运行以下命令，确保令牌验证步骤忽略 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。

解决方案

如果您的安装是新的，请关闭并重新打开终端应用程序。如果您希望终端保持打开状态，则可以 source 您的 ~/.zshrc 文件（在 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

例如，如果您使用 .sh 安装程序 (~/anaconda3/) 将 Anaconda Distribution 安装到默认位置，则您的命令将如下所示

~/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 时不会自动激活您的 base 环境。此行为模拟您的系统 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 时，您的 base 环境将不会处于活动状态。要激活您的 base 环境，请运行 conda activate。

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

注意

anaconda 元包已于 2023 年 2 月从 Anaconda Distribution 安装程序中删除，并且默认情况下不再出现在您的 base 环境中。本故障排除主题假定您正在处理包含 anaconda 元包的环境中的包不兼容问题。

原因

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

解决方案

1. 通过运行 conda update anaconda 或 conda install anaconda=2023.07 获取冲突包的列表。

   注意

   将 2023.07 替换为最新的版本号。

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

3. 一旦您知道哪些包冲突，您可以

   • 更新所有当前包，而不升级到最新版本的 anaconda 元包，或者

   • 删除冲突的包，然后升级到最新版本的 anaconda 元包。

—

要更新所有当前包，而不升级到最新版本的 anaconda 元包

1. 通过运行以下命令删除 anaconda 元包本身

   conda remove anaconda
   

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

   conda update --all
   

—

要删除冲突的包并升级到最新版本的 anaconda 元包

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

   conda remove <PACKAGE>
   

2. 更新到最新版本的 anaconda 元包

   conda update anaconda
   

恢复您的 Anaconda 安装

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

解决方案

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

   注意

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

   Windows

   1. 打开终端应用程序，例如命令提示符。

   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 Distribution 问题

在防火墙或代理服务器后使用 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

原因

在安装或搜索软件包时，您可能会看到进程突然结束并显示 “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 Distribution 中的 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 未被识别为内部或外部命令” 或类似的消息，并且无论您在哪个路径上，都无法在终端窗口中执行 conda。如果您使用 Anaconda Prompt 终端对话框，则在 Windows 中不会发生这种情况。

原因

当您安装 Anaconda 或 Miniconda 时，您很可能对有关将 conda 提示符添加到您的 PATH 的问题回答了 “否”。

解决方案一

卸载然后重新安装 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 安装程序时，您可能会在 “安装” 步骤中遇到此错误

原因

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

解决方案

手动选择合适的安装位置。以下示例显示了如何选择用户的 home 目录。

1. 重新运行安装程序，然后单击直到到达 “安装类型” 或 “选择目标” 页面。

2. 如果您先到达 “安装类型” 页面，请单击 更改安装位置…。这将带您到 “选择目标” 页面。

   

3. 单击 安装在特定磁盘上…。

4. 选择合适的目标驱动器。然后单击 选择文件夹…。

   

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

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

   

7. 单击 安装，然后继续执行安装的其余步骤。

如果您继续收到相同的错误消息，请在此处打开问题，并确保包含来自您的 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

Chrome

1. 在 anaconda.com 上查找最新的安装程序，或在 repo.anaconda.com/archive 上查找较旧的安装程序。

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

3. 单击 恢复 以继续中断的下载。

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

Edge

1. 在 anaconda.com 上查找最新的安装程序，或在 repo.anaconda.com/archive 上查找较旧的安装程序。

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

3. 单击 下载 以打开 “下载” 对话框。

4. 从这里，您可以使用播放、暂停和取消按钮来控制正在进行的下载。

提示

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

Internet Explorer

1. 在 anaconda.com 上查找最新的安装程序，或在 repo.anaconda.com/archive 上查找较旧的安装程序。

2. 单击 工具.

3. 单击 查看下载 以打开 “下载管理器”。

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>
   

   注意

   -C 标志是 “继续” 的选项。您可以根据需要多次暂停和重新启动下载。

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. 卸载 先前的安装。然后重新运行安装程序，确保选择 仅为我安装 选项。

Windows 特定的 Anaconda Distribution 问题

在 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 安装。

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

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

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

注意

要查找您的路径变量

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

2. 在侧边栏中选择 编辑系统环境变量。

3. 在 “系统属性” 对话框中单击 环境变量。

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

5. 单击 编辑。

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. 開啟開始選單，然後點擊 Reset Spyder Settings（重置 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 安裝資料夾，並從該位置執行 .exe 檔案解除安裝程式。解除安裝將在不提示管理員權限的情況下完成。

範例：如果您安裝了 Miniconda3，則解除安裝檔案將為 Uninstall-Miniconda3.exe。安裝 Miniconda2 或 Anaconda 的使用者會找到名稱相似的檔案。

從「我的最愛」資料夾安裝時出現 Windows 權限錯誤

原因

Windows 「我的最愛」資料夾具有不尋常的權限，並且可能導致任何軟體的安裝程式出現權限錯誤。如果您嘗試從「我的最愛」資料夾啟動安裝程式，您可能會看到諸如 “Setup was unable to create the directory（安裝程式無法建立目錄）”、“Access is denied（拒絕存取）” 或 “Error opening file for writing（開啟檔案以進行寫入時發生錯誤）” 之類的錯誤。

解决方案

將安裝程式移動到不同的資料夾，然後從新的資料夾執行安裝程式。

在 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. 開啟命令提示字元視窗。

2. 導航到您安裝 conda 的位置。以下命令顯示預設位置

   cd C:\Users\<USERNAME>
   

3. 執行以下命令

   python -m conda init
   

4. 關閉命令提示字元視窗。

注意

如果上述方法無效，請嘗試執行

conda update conda

macOS 特定的 Anaconda Distribution 問題

“Conda: command not found（Conda：找不到命令）” 在 zsh shell 中

原因

如果您在 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
   

   例如，如果您使用 .sh 安裝程式 (~/miniconda3/) 將 Miniconda 安裝到預設位置，則命令將為

   ~/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。

操作	Python < 3.8	Python >= 3.8
取得連結到擴充模組的命令列	python -c "import sysconfig; print(sysconfig.get_config_var('LDSHARED'))"	python3-config --ldflags
取得嵌入 Python 直譯器的命令列	python3-config --ldflags	python3-config --ldflags --embed

python3-config 不包含命令/編譯器名稱，而 sysconfig 方法則包含。如果您的任何引數都沒有空格，則此方法有效

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

Linux 特定的 Anaconda Distribution 問題

Power8 上缺少 libgomp

如果 Python 命令 import numpy 失敗，則系統可能缺少 libgomp 系統程式庫。

原因

大多數 Power8 Linux 發行版都包含 libgomp，但有些可能沒有。

解决方案

透過執行以下命令來檢查系統是否缺少 libgomp

conda inspect linkages --name root numpy

如果在 not found: 區段中列出了 libgomp.so.1，則必須安裝它。

透過執行以下命令在 Ubuntu 上安裝 libgomp

apt install libgomp1

透過執行以下命令在 Red Hat Enterprise Linux (RHEL) 或 CentOS 上安裝 libgomp

yum install libgomp

Power8 上的 Anaconda 報告 “can not execute binary file（無法執行二進位檔案）”

原因

Power8 上的 Anaconda 僅支援小端模式。小端 Python 二進位檔案無法在大端作業系統上執行。

解决方案

在小端 Linux 安裝或 VM 上安裝 Power8 上的 Anaconda。

Anaconda Distribution 安裝失敗，並顯示 “‘ascii’ codec can’t encode character ‘xe4’ in position 96（“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 問題

Navigator 無法更新到 2.6.4 版本

原因

如果您使用的是 Navigator 2.6.3 版本，並且無法更新到 2.6.4 版本，則可能是因為 anaconda-navigator 套件和 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/終端機。

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。

• 如果移除授權目錄無法解決問題，請透過開啟 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>')
   

拒絕存取錯誤

原因

這是由鎖定檔案引起的，該檔案有時會卡住並且在應該移除時沒有移除。

解决方案

開啟 Anaconda Prompt (macOS/Linux 上的「終端機」) 並執行以下命令來移除鎖定檔案

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

Navigator 按鈕遺失

原因

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. 在 Navigator 組態檔 (anaconda-navigator.ini) 中將 logged_api_url、anaconda_server_token 和 anaconda_server_token_id 設定為 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 組態檔 (.condarc) 中移除 channel_alias。

3. 再次嘗試登入。

VS Code 未顯示在 Navigator 的「首頁」標籤中

子句

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 應用程式從「下載」資料夾移動到「應用程式」資料夾。

  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) 上顯示 “Permission denied（拒絕權限）” 錯誤。

原因

此錯誤可能是由於 anaconda-client 是以管理員權限安裝的。這將導致 anaconda-client 組態檔的使用者權限不正確。

解决方案

您可以執行一些操作來解決此問題。它們從最直接到最複雜的順序列出。

刪除您的 .continuum 資料夾

1. 將您的 .config.yaml 檔案備份到不同的位置。

2. 刪除您的 .continuum 資料夾。

3. 再次啟動 Navigator。

4. 將您儲存的 .config.yaml 檔案複製回 /.continuum/anaconda-client。

解除安裝並重新安裝，不使用管理員權限

解除安裝 Anaconda，然後重新安裝 Anaconda，不使用管理員權限。

手動變更 .continuum 資料夾的使用者權限

您需要管理員權限才能執行此操作。

Windows

1. 搜尋 “powershell”。

2. 右鍵點擊 Windows PowerShell 應用程式，然後選擇 以管理員身分執行。

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 顯示 ‘Email verification failed（電子郵件驗證失敗）’ 錯誤 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 無法啟動，並顯示 “Could not load the Qt platform plugin “xcb” in “” even though it was found（即使找到，也無法在“”中載入 Qt 平台外掛程式“xcb”）” 錯誤

原因

在 CentOS 7 Linux 作業系統中，Orange3 缺少 Qt 所需的一些圖形程式庫，Qt 是 Orange Canvas 運作所需的框架。

這些缺少的依賴項會在啟動 Navigator 時導致錯誤：“Could not load the Qt platform plugin “xcb” in “” even though it was found. This application failed to start because no Qt platform plugin could be initialized.（即使找到，也無法在“”中載入 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 及更高版本中，如果使用者尚未登入 Anaconda Cloud，則每小時（或從 2.6.2 版本開始每 24 小時）會出現一個對話方塊，提醒使用者登入 Anaconda Cloud。這可能會對不想登入 Anaconda Cloud 的使用者造成干擾。

解决方案

停用 Anaconda Cloud 登入提醒有幾種方法，具體取決於您的 Navigator 版本

2.6.1 及更高版本

在離線模式或登入另一個儲存庫中工作。

2.5.2 到 2.6.0

1. 開啟 Navigator 組態檔.

2. 將組態檔的 [internal] 區段中的 cloud_login_popup_state 編輯為 0。

   [internal]
   anaconda_toolbox_installed = True
   cloud_login_popup_state = 0
   

2.5.0

1. 開啟 Navigator 組態檔.

2. 將組態檔的 [internal] 區段中的 welcome_state 編輯為 0。

   [internal]
   welcome_state = 0
   

更新彈出視窗未自動顯示

原因

如果您在登入時未自動收到更新 Navigator 的提示，則可能有幾個原因。

• 對話方塊已隱藏

• 您的套件索引不同步

• defaults 從您的通道列表中遺失

解决方案

對話方塊已隱藏

您可能在「更新」彈出視窗中點擊了 Do not show again（不再顯示）。如果這是「更新」彈出視窗未顯示的唯一原因，您仍然應該在 Connect（連線） 旁邊看到 Update now（立即更新） 選項。要更新，請點擊 Update now（立即更新）。

要讓「更新」彈出視窗再次自動顯示

1. 從 File（檔案） 或 Anaconda Navigator 選單開啟 Preferences（偏好設定）。

2. 取消選取 Hide update dialog on startup（啟動時隱藏更新對話方塊）。

您的套件索引不同步

如果您的套件表格未正確更新，Navigator 將無法辨識更新可用。要更新您的套件表格，請點擊 Environments（環境），然後點擊 Update index…（更新索引…）。

defaults 從您的通道列表中遺失

未將 defaults 新增到您的通道列表中也可能導致 Navigator 的「更新」彈出視窗無法顯示。

注意

此問題特別影響未訂閱我們進階儲存庫的使用者。

要將 defaults 新增到您的通道列表中

1. 點擊 Home（首頁） 或 Environments（環境） 頁面上的 Channels（通道）。

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 no longer exists and has been permanently removed（URI 不再存在且已永久移除）” 410 錯誤

原因

筆記本和環境功能已從 Anaconda.org 中移除，這是簡化和改進 Anaconda.org 並使網站能夠專注於套件託管和管理的措施的一部分。因此，不再可以使用 anaconda upload 命令將筆記本和環境檔案上傳到 Anaconda.org。

解决方案

雖然您無法再將筆記本上傳到 Anaconda.org，但您可以使用 Anaconda Notebooks 與他人共用您的筆記本。Anaconda Notebooks 隨附其自己的預先載入的環境 <../anaconda-notebooks/notebook-environments>，並允許您建立自己的自訂環境。有關使用 Anaconda Notebooks 共用筆記本的更多資訊，請參閱共用筆記本。