适用范围与先保存的记录

适用于已能运行 conda 命令的 Windows、macOS、Linux 环境,不用于安装 Conda 本身。使用普通用户终端;Windows 可用已初始化 Conda 的终端。官方页面本次读取标识为 Conda 26.9.4,不代表你应立即升级。本文仅核对资料,没有访问你的环境、账号或执行安装。

先记下报错属于连接超时、代理认证、证书失败,还是找不到包。包不存在或当前平台没有相应构建,不能单凭这两种结果判断断网。先固定原 channel 与同一查询条件,再改网络配置。

第一步:区分配置文件和最终生效值

各桌面平台 Conda 终端;只读配置,不修改环境
conda --version
conda config --show-sources
conda config --show proxy_servers ssl_verify channels offline
conda config --validate

show-sources 列出识别到的配置来源;show 显示合并后的有效值;validate 检查配置解析错误。输出可能含私有仓库 URL 或代理凭据,只在本机查看,分享前脱敏。预期先看到配置可解析,并能指出每个待改项来自哪个文件。

Conda 的列表和字典会合并,标量值会覆盖。CONDA_ 开头的配置环境变量优先于文件,命令行选项又优先于它们。因此“删了用户 .condarc 仍没变”并不奇怪,应根据来源和有效值查原因,而不是继续删文件。

第二步:先改一个可回退的配置片段

  1. 从上一步找到由自己管理且可写的配置文件,复制备份。若它属于系统或单位管理,交给管理员修改,不用管理员权限绕过。
  2. 检查原来是否已有 proxy_servers,将下面片段合并进去;已有映射应编辑相应键,不能再加第二个同名顶层键。
  3. 把 PORT 替换为正在运行的本机 HTTP 或 mixed 代理入口端口;保存后重跑 validate 与 show,确认最终值确实改变。
YAML 示例;PORT 必须替换,使用空格缩进;不要覆盖 channels 等原有项
proxy_servers:
  http: http://127.0.0.1:PORT
  https: http://127.0.0.1:PORT

左侧 https 表示 HTTPS 目标流量,右侧 http:// 表示连接代理本身使用 HTTP,两者可以不同。只有代理入口确实提供 TLS 时才写 https://。这里不使用 SOCKS 专用端口,也不提供需要明文账号的示例。配置 proxy_servers 会覆盖默认从系统或 HTTP_PROXY、HTTPS_PROXY 获取代理的行为。

第三步:证书报错不要当作端口报错处理

结果处理方向
连接被拒绝或超时先确认进程、地址与端口,再查出口
代理要求认证核对单位规定的认证方法,不反复换仓库
证书验证失败核对报错主机、系统时间及企业 CA 信任
索引返回正常但找不到包核对 channel、包名、版本和平台

若单位网络检查 TLS,由管理员提供并核验 CA 文件后,可以把 ssl_verify 设为该文件的路径。不要下载不明证书或关闭验证。若 CA 已被操作系统信任,官方说明 truststore 还要求 Conda 23.9.0 及以上、运行 Conda 的 Python 3.10 及以上;项目环境中的 Python 版本不能代替这项条件。条件不明确时使用经核验的 CA 路径,或先请管理员确认。

第四步:用查询定位到具体 channel

查询当前 channels 中的 zlib;不安装包,但可能联网并更新本地索引缓存
conda search zlib

预期看到包的版本和构建列表。若当前 channel 本就不提供 zlib,可换成已知存在的包名;不要因此直接修改默认 channel。查询可能使用缓存,返回列表只能证明当前查询可完成,应结合输出中的索引请求判断是否实际联网。它不证明后续求解、下载包文件和安装全部成功。

需要单独定位某个已批准的仓库时,按 search 手册使用 -c 与 --override-channels;后者要求同时指定 channel,并仅在本次查询忽略默认与 .condarc 的 channel 列表。先核对实际 URL,避免把私有包查询发到无关公共仓库。

失败后的恢复和下一步

  1. 恢复本次改动前的文件,或逐项恢复原值;若只为排障创建了新文件,确认无其他内容后移除它。不要删除整套环境或包缓存。
  2. 重新运行 show-sources、show 和 validate,确认回到预期配置。使用 conda config 写入时,默认目标是用户配置;只有明确选定 --file 或 --env 才是对应范围。
  3. 用同一查询复测,报告 Conda 版本、运行环境、channel 主机、错误类别及本次改动。查询已正常但安装失败时,记录失败是在求解、包下载还是安装,继续缩小范围。