很多刚开始用Spyder的朋友都会在一个问题上卡住明明想在Spyder里装个第三方库结果打开命令行敲pip要么提示“pip不是内部或外部命令”要么在Spyder的IPython控制台里不知道怎么执行。更尴尬的是有人的Spyder是从Anaconda装的自带的base环境里其实已经有pip但因为环境变量或者路径问题一敲pip就报错。这篇东西就是专门解决这个痛点的。我会从最底层的逻辑讲起Spyder、Anaconda、Python解释器、pip到底是什么关系然后在不同场景下给出安装pip的方法再重点演示如何在Spyder里用pip安装第三方库包括换国内源、离线安装这种实操中一定会遇到的场景。最后把我这些年踩过的坑和排查思路整理成速查表方便你直接对照解决。无论你是刚接触Python的纯新手还是用Spyder写数据分析脚本但一直没搞懂包管理的老朋友这篇文章都能帮上忙。我尽量不堆术语所有关键步骤都能照着做。1. 先搞清楚Spyder里为什么还要pippip到底装在哪1.1 Spyder、Anaconda、Python解释器三者关系很多人以为Spyder就是Python或者以为Spyder自带了一个Python。这是个很核心的误解。Spyder本质上是一个集成开发环境IDE它只负责提供编辑器、变量查看、Debug工具这些界面功能。真正执行代码的是底层那个Python解释器。在大多数情况下Spyder是从Anaconda启动的它默认对接的是Anaconda安装目录下的Python解释器也就是base环境。你可以理解为Spyder是驾驶舱Python解释器是发动机而pip就是给发动机加油的工具。pip是Python官方的包管理工具它的职责是下载、安装、卸载第三方库。pip不是一个独立软件它寄生在某个Python环境里帮这个环境装包。所以“在Spyder中安装pip”这句话严格来说应该理解为给Spyder正在使用的那个Python环境安装pip。想通了这一点后续很多报错都能找到根源。1.2 判断当前环境到底有没有pip先别急着装动手之前要检查一下当前环境有没有pip。在Spyder的IPython控制台里可以依次输入下面的命令来确认import sys print(sys.executable)这一步输出的是当前Spyder绑定的Python解释器绝对路径非常重要。记下这个路径后面所有操作都要围绕它展开。然后检查pip是否可用你可以用任意一种方式# 方式一以模块方式运行最推荐 python -m pip --version # 方式二直接运行pip命令 pip --version # 方式三在Python代码里导入 import pip print(pip.__version__)如果python -m pip --version能正常输出版本号比如pip 23.0.1 from C:...\site-packages\pip那说明pip已经存在只是你敲pip命令报错那属于环境变量问题后面第五节我会讲。如果提示“No module named pip”或者“pip is not recognized”那才是真正需要手动安装pip的场景进入下一节。2. 给当前Python环境安装pip的几种靠谱方法2.1 Anaconda用户首选用conda补装pip如果你用的是Anaconda或Miniconda最稳妥的方案是用conda来装pip因为conda能自动处理依赖关系不会把环境搞乱。打开Anaconda Prompt或者系统终端先确认你处于哪个环境。如果没有特别创建虚拟环境默认就是base环境conda activate base conda install pip这个过程会解析依赖选“y”确认安装即可。如果你用的是Spyder单独安装版没有conda命令那这个方法就不适用改用下面两种。用conda装pip的好处是pip会安装到当前激活的conda环境目录下和Spyder默认绑定的Python解释器天然一致。很多新手用别的办法装pip装完发现Spyder里还是import不到任何pip问题就出在环境错位。2.2 用Python自带的ensurepip做自修复Python安装包里其实隐藏了一个叫ensurepip的模块它的功能就是“在没有pip的环境里装一个基础的pip”。这个方案对那些只需要一个能用的pip、不想下载额外脚本的人来说非常省事。在Spyder的IPython控制台里或者在Python解释器所在目录的终端里运行python -m ensurepip --upgrade执行完再验证一下python -m pip --version如果显示正常接着可以考虑把pip升级到最新版python -m pip install --upgrade pip这个方法的局限性在于ensurepip安装的pip版本可能偏旧所以装完以后大概率还要升级一次。但作为“先把pip用起来”的兜底方案它足够稳。2.3 通用方案使用get-pip.py官方脚本如果你是纯Python安装或者pip彻底损坏无法修复那就用官方脚本get-pip.py。第一步是下载脚本。在浏览器打开官方地址https://bootstrap.pypa.io/get-pip.py保存到本地或者如果你有curl/wget也可以curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py国内网络访问官方地址有时候慢你也可以先用其他渠道把这个文件下载好文件本身很小只有几百KB。然后在这个文件所在目录打开终端运行python get-pip.py如果你是想给用户级环境装而不是写到系统目录可以加--user参数python get-pip.py --user装完后同样用python -m pip --version验证。这里我要特别提醒一句如果你的机器上装了多个Python版本比如Python 3.8和3.11并存那你执行python get-pip.py时到底用的是哪个Python完全取决于环境变量里python指向哪个。建议你执行前先运行python --version确认一下别辛辛苦苦装完发现装到了另一个版本的解释器里。2.4 三种方案怎么选我给你的建议用表格总结一下适用场景场景推荐方案理由Anaconda / Miniconda 用户conda install pip环境一致依赖解析可靠官方Python安装包pip缺失python -m ensurepip --upgrade无需联网下载快速恢复pip彻底损坏或需要指定版本get-pip.py官方脚本可控性强不想动系统环境get-pip.py --user只对当前用户生效我个人的习惯是只要环境里能跑conda一律用conda装只有脱离conda的裸Python环境才考虑ensurepip或get-pip.py。这样能最大程度避免“装完了但Spyder不认识”的尴尬。3. 在Spyder里调用pip安装第三方库的正确姿势3.1 在IPython控制台里用!pip install注意别犯这个错安装完pip之后很多人的第一反应是回到Spyder的IPython控制台直接敲pip install xxx。但你会得到一个NameError。原因很简单IPython控制台本质是Python交互环境pip在这里不是一个Python内置变量直接敲会被当成Python代码解析。正确做法是加一个英文感叹号让IPython把这一行当作系统命令执行!python -m pip install pandas在IPython里以!开头的内容会传给底层操作系统去执行。所以我推荐你写成python -m pip install而不是直接!pip install。两者有什么差别直接!pip install调用的是环境变量PATH里找到的那个pip脚本而python -m pip install调用的是当前Python解释器自带的pip模块。在Spyder这种经常对接多个Python环境的场景下第二种写法几乎不会出错它必定装进当前Spyder正在使用的环境里。这是我从多次踩坑中总结出来的铁律。安装完成后你可以在同一个控制台里验证import pandas print(pandas.__version__)如果能正常输出版本号就说明安装成功。3.2 在系统终端或Anaconda Prompt里安装如果你更喜欢传统的命令行窗口那操作方式是在Spyder外部打开终端工具。先激活你Spyder正在使用的那个conda环境。比如Spyder绑定的是base环境conda activate base然后安装python -m pip install openpyxl如果你不确定当前环境是否对应可以再次检查sys.executable一定要确认终端里的Python路径和Spyder的Python路径一致否则就会装到别的环境里造成“明明装成功了Spyder里却import不到”的灵异事件。3.3 通过Spyder自带的“安装/管理包”图形界面在新版Spyder中菜单栏的“工具”里可以找到包管理入口。不同版本位置略有差异常见的是在Tools菜单下选择“Install and manage packages”界面会弹出一个包管理器窗口。这个管理器本质上也是调用pip来实现安装但它简化了操作界面里可以直接输入包名、选择版本、配置镜像源。如果你不习惯命令行用这个界面就好。需要注意的是这里安装的目标环境默认是Spyder当前绑定的环境装之前最好确认一下界面顶部显示的解释器路径别稀里糊涂装进了一个你根本不用的小环境。3.4 我应该用conda install还是pip install这是一个很多新手都会纠结的问题。原则其实很简单conda install适用于conda源里有的包能解决底层的依赖冲突尤其是那些需要编译的库比如numpy、scipy、pandas。pip install适用于conda源里没有的包或者你想装最新版本、或者明确知道包只发布在PyPI上。在实际操作中很多纯Python包用pip装更快、版本更新。但如果底层依赖复杂用conda装会更省心。比如numpy这种你用pip装到某些系统上可能会踩到编译工具的坑而conda直接分发二进制包省去了很多麻烦。我的建议是大数据和科学计算类的核心库优先conda其他边角功能库用pip。两条命令在你的环境里可以共存互相不冲突。4. 给pip配置国内镜像源安装速度快十倍4.1 为什么默认PyPI那么慢一个命令临时换源pip安装第三方库默认是从PyPI官方源下载pypi.org。这个源服务器在国外国内网络访问经常出现连接超时、速度几KB每秒、下载到一半失败的问题。解决办法是换用国内镜像源。常用的有这么几个镜像源地址阿里云https://mirrors.aliyun.com/pypi/simple/清华TUNAhttps://pypi.tuna.tsinghua.edu.cn/simple中科大https://pypi.mirrors.ustc.edu.cn/simple/豆瓣https://pypi.douban.com/simple/临时换源很简单安装时用-i参数指定源即可python -m pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple如果使用的是最新版pip镜像源还支持--index-url的完整形式但日常使用-i这个简写就够了。如果你在配置严格的环境里有时还需要加上信任主机的参数python -m pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn出现SSL证书报错时这个参数能临时绕过证书验证问题但注意这属于降低安全性的做法只建议在可信内网环境使用。4.2 永久配置pip源一劳永逸不折腾如果觉得每次安装都带-i参数太麻烦可以直接把镜像源写进pip的配置文件这样以后pip默认使用国内源。Windows系统下你需要在当前用户的目录下创建一个pip文件夹然后在里面新建pip.ini文件。路径大概是C:\Users\你的用户名\pip\pip.iniLinux或macOS系统需要在用户目录下创建pip.conf文件~/.pip/pip.conf文件内容[global] index-url https://pypi.tuna.tsinghua.edu.cn/simple [install] trusted-host pypi.tuna.tsinghua.edu.cn保存后执行python -m pip config list如果能列出刚才的配置就说明已经生效。以后安装第三方库直接写pip install包名pip会默认从清华源拉取。这里犯懒的人特别多我多说一句配置文件的名字和路径不要写错Windows下是pip.ini不是pip.txt也不是pip.conf。有人建了个pip.conf.ini结果配置半天不生效查了很久才发现文件名的问题。4.3 完全离线安装第三方库从下载到部署有些单位的开发环境是物理隔离的内网不能访问外网。这时候没办法在线安装需要在一台能上网的机器上下载好安装包再拷贝到内网机器上安装。在有网的机器上执行# 创建一个目录存放安装包 mkdir offline_pkgs # 下载包及其所有依赖到指定目录 python -m pip download -d offline_pkgs pandas requests如果项目依赖特别多更推荐用requirements.txt统一管理python -m pip download -d offline_pkgs -r requirements.txt下载完成后把offline_pkgs整个文件夹拷贝到内网机器上。然后在内网机器上执行python -m pip install --no-index --find-linksoffline_pkgs -r requirements.txt这里有两个关键参数--no-index告诉pip不要去远程索引查找只使用本地包。--find-links指定本地包所在目录。离线安装最大的坑在于版本兼容性。pip download下载的包与下载机的Python版本、操作系统位数强相关。比如在Windows Python 3.11上下载的包很可能无法装到Linux Python 3.8上。所以务必使用同架构、同版本甚至同系统类型的机器来执行下载操作。如果你只想安装单个.whl或.tar.gz文件也可以用python -m pip install 包名.whl这种方式不用指定网络源pip直接从本地文件安装也是离线安装的一种补充方式。5. 常见报错与排查记录这些坑我都替你踩过5.1 提示“pip不是内部或外部命令”或“无法将pip识别为cmdlet”这个报错在Windows上极其常见。出现它的原因是pip的脚本目录没有被加入系统环境变量PATH。pip脚本通常位于Python安装目录下的Scripts子目录。比如C:\Users\你的用户名\AppData\Local\Programs\Python\Python311\ScriptsAnaconda环境下则在Anaconda目录下的Scripts目录。解决思路有两个第一个思路是以后都改用python -m pip因为只要你还能运行python这个命令就能正常工作完全不依赖PATH。第二个思路是把这个Scripts目录手动加到PATH里。具体操作为打开“系统属性”中的“环境变量”找到Path在末尾追加Scripts目录地址保存后重启终端工具。我强烈建议你在环境变量问题上有洁癖一点不要一次往PATH里塞一堆目录。加多了以后多版本Python、多个pip并存各种诡异问题会排队来找你。5.2 提示“Fatal error in launcher: Unable to create process using...”这个报错往往发生在多个Python版本共存时。系统里原来装了某个Python的pip后来卸掉了或者更换了解释器的路径pip.exe里记录的Python路径已经失效于是双击或者调用pip时就会提示launcher错误。解决办法是用当前可用的Python解释器强制重装pippython -m pip install --upgrade --force-reinstall pip这条命令会用当前正在执行的python来重建pip脚本让launcher指向正确的Python路径。如果这条命令都执行不了说明当前环境里pip模块也不完整了那就回到第二节先跑python -m ensurepip --upgrade修复基础再升级。5.3 提示“Could not fetch URL https://pypi.org/simple/pip/ ... SSL”这个报错我在公司内网遇到过很多次。原因通常是机器访问internet需要走代理而pip没有配置代理或者某个安全软件拦截了pip的访问请求。结合前面的换源方案最快速的解决办法是换用国内镜像源python -m pip install 包名 -i https://pypi.tuna.tsinghua.edu.cn/simple如果换源依然报SSL错误再检查系统代理设置确认环境变量中HTTP_PROXY和HTTPS_PROXY是否配置正确。如果是在公司网络环境去掉代理配置或者放行pypi.org域名往往就能解决。如果暂时不需要访问网络只是想安装本地包用刚才提到的离线安装命令即可绕过网络检查。5.4 pip提示“You are using pip version 20.3.1; however, version 25.0.1 is available”这个提示不是报错纯粹是好心提醒你pip有新版。但如果你是在内网环境每次都会看到它还挺烦人的。可以执行升级python -m pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple如果升级不了或者在离线环境也可以忽略这个提示不影响你安装其他包。或者设置环境变量PIP_DISABLE_PIP_VERSION_CHECK1来关闭这个检查。5.5 包明明装成功了Spyder里就是import不到这个问题出现的频率极高原因几乎永远只有一个pip安装时使用的Python环境和Spyder当前绑定的Python环境不是同一个。比如你在终端里执行pip install装到了系统自带的Python环境而Spyder绑定的是Anaconda的base环境。包确实装成功了但装在了一个Spyder根本不会用到的环境里当然import不到。排查步骤在Spyder的IPython控制台运行import sys; print(sys.executable)记下路径A。打开终端运行python -c import sys; print(sys.executable)记下路径B。对比A和B如果不同说明两个环境确实不一致。解决办法是让Spyder切换到pip安装时使用的那个环境或者在Spyder环境里重新安装这个包。在Spyder中切换环境的方法是菜单栏“工具” - “偏好设置” - “Python解释器”然后选择“使用以下解释器”把路径指向你想要的那个Python。我在实际使用中还碰到过一种隐蔽的情况Spyder的IPython console是在旧环境里打开的我改了Spyder的解释器配置但控制台没重启。这时候需要点控制台右上角的“重启内核”Python环境才会真正刷新。5.6 常见问题速查表报错原话原因解决动作pip 不是内部或外部命令pip脚本不在PATH改用python -m pip或把Scripts目录加入PATHNo module named pip环境里没有pippython -m ensurepip --upgrade或get-pip.pyFatal error in launcherpip入口脚本绑定的Python失效python -m pip install --upgrade --force-reinstall pipCould not fetch URL ... SSL网络无法访问PyPI换国内镜像源或配置代理pip is not recognized ... cmdletPowerShell里pip不可用使用python -m pip命令import不了刚装的包环境不一致重启Spyder内核核对sys.executable路径最后说点个人体会写了这么多其实核心就一句话用pip之前先弄清楚你当前是哪个Python环境然后用python -m pip这个姿势去安装基本能避开九成以上的坑。剩下的就是镜像源问题国内直接永久配置清华源你会发现pip install的体验瞬间从“煎熬”变成“丝滑”。我再分享一个小技巧每次装完一个库我习惯在Spyder的IPython控制台里多敲一步验证——import这个库然后打印版本号。这样做成本极低但能第一时间发现装进错误环境的问题比等到写代码时才发现import失败要省心得多。如果你正在Spyder环境里折腾pip希望这篇东西能让你少走点弯路。能顺利装上库、写出自己的代码这比什么都强。 
长河君 · 2026/10/1 8:55:54 · 阅读 1.2k Spyder中安装pip与配置环境实战指南
很多刚开始用Spyder的朋友都会在一个问题上卡住明明想在Spyder里装个第三方库结果打开命令行敲pip要么提示“pip不是内部或外部命令”要么在Spyder的IPython控制台里不知道怎么执行。更尴尬的是有人的Spyder是从Anaconda装的自带的base环境里其实已经有pip但因为环境变量或者路径问题一敲pip就报错。这篇东西就是专门解决这个痛点的。我会从最底层的逻辑讲起Spyder、Anaconda、Python解释器、pip到底是什么关系然后在不同场景下给出安装pip的方法再重点演示如何在Spyder里用pip安装第三方库包括换国内源、离线安装这种实操中一定会遇到的场景。最后把我这些年踩过的坑和排查思路整理成速查表方便你直接对照解决。无论你是刚接触Python的纯新手还是用Spyder写数据分析脚本但一直没搞懂包管理的老朋友这篇文章都能帮上忙。我尽量不堆术语所有关键步骤都能照着做。1. 先搞清楚Spyder里为什么还要pippip到底装在哪1.1 Spyder、Anaconda、Python解释器三者关系很多人以为Spyder就是Python或者以为Spyder自带了一个Python。这是个很核心的误解。Spyder本质上是一个集成开发环境IDE它只负责提供编辑器、变量查看、Debug工具这些界面功能。真正执行代码的是底层那个Python解释器。在大多数情况下Spyder是从Anaconda启动的它默认对接的是Anaconda安装目录下的Python解释器也就是base环境。你可以理解为Spyder是驾驶舱Python解释器是发动机而pip就是给发动机加油的工具。pip是Python官方的包管理工具它的职责是下载、安装、卸载第三方库。pip不是一个独立软件它寄生在某个Python环境里帮这个环境装包。所以“在Spyder中安装pip”这句话严格来说应该理解为给Spyder正在使用的那个Python环境安装pip。想通了这一点后续很多报错都能找到根源。1.2 判断当前环境到底有没有pip先别急着装动手之前要检查一下当前环境有没有pip。在Spyder的IPython控制台里可以依次输入下面的命令来确认import sys print(sys.executable)这一步输出的是当前Spyder绑定的Python解释器绝对路径非常重要。记下这个路径后面所有操作都要围绕它展开。然后检查pip是否可用你可以用任意一种方式# 方式一以模块方式运行最推荐 python -m pip --version # 方式二直接运行pip命令 pip --version # 方式三在Python代码里导入 import pip print(pip.__version__)如果python -m pip --version能正常输出版本号比如pip 23.0.1 from C:...\site-packages\pip那说明pip已经存在只是你敲pip命令报错那属于环境变量问题后面第五节我会讲。如果提示“No module named pip”或者“pip is not recognized”那才是真正需要手动安装pip的场景进入下一节。2. 给当前Python环境安装pip的几种靠谱方法2.1 Anaconda用户首选用conda补装pip如果你用的是Anaconda或Miniconda最稳妥的方案是用conda来装pip因为conda能自动处理依赖关系不会把环境搞乱。打开Anaconda Prompt或者系统终端先确认你处于哪个环境。如果没有特别创建虚拟环境默认就是base环境conda activate base conda install pip这个过程会解析依赖选“y”确认安装即可。如果你用的是Spyder单独安装版没有conda命令那这个方法就不适用改用下面两种。用conda装pip的好处是pip会安装到当前激活的conda环境目录下和Spyder默认绑定的Python解释器天然一致。很多新手用别的办法装pip装完发现Spyder里还是import不到任何pip问题就出在环境错位。2.2 用Python自带的ensurepip做自修复Python安装包里其实隐藏了一个叫ensurepip的模块它的功能就是“在没有pip的环境里装一个基础的pip”。这个方案对那些只需要一个能用的pip、不想下载额外脚本的人来说非常省事。在Spyder的IPython控制台里或者在Python解释器所在目录的终端里运行python -m ensurepip --upgrade执行完再验证一下python -m pip --version如果显示正常接着可以考虑把pip升级到最新版python -m pip install --upgrade pip这个方法的局限性在于ensurepip安装的pip版本可能偏旧所以装完以后大概率还要升级一次。但作为“先把pip用起来”的兜底方案它足够稳。2.3 通用方案使用get-pip.py官方脚本如果你是纯Python安装或者pip彻底损坏无法修复那就用官方脚本get-pip.py。第一步是下载脚本。在浏览器打开官方地址https://bootstrap.pypa.io/get-pip.py保存到本地或者如果你有curl/wget也可以curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py国内网络访问官方地址有时候慢你也可以先用其他渠道把这个文件下载好文件本身很小只有几百KB。然后在这个文件所在目录打开终端运行python get-pip.py如果你是想给用户级环境装而不是写到系统目录可以加--user参数python get-pip.py --user装完后同样用python -m pip --version验证。这里我要特别提醒一句如果你的机器上装了多个Python版本比如Python 3.8和3.11并存那你执行python get-pip.py时到底用的是哪个Python完全取决于环境变量里python指向哪个。建议你执行前先运行python --version确认一下别辛辛苦苦装完发现装到了另一个版本的解释器里。2.4 三种方案怎么选我给你的建议用表格总结一下适用场景场景推荐方案理由Anaconda / Miniconda 用户conda install pip环境一致依赖解析可靠官方Python安装包pip缺失python -m ensurepip --upgrade无需联网下载快速恢复pip彻底损坏或需要指定版本get-pip.py官方脚本可控性强不想动系统环境get-pip.py --user只对当前用户生效我个人的习惯是只要环境里能跑conda一律用conda装只有脱离conda的裸Python环境才考虑ensurepip或get-pip.py。这样能最大程度避免“装完了但Spyder不认识”的尴尬。3. 在Spyder里调用pip安装第三方库的正确姿势3.1 在IPython控制台里用!pip install注意别犯这个错安装完pip之后很多人的第一反应是回到Spyder的IPython控制台直接敲pip install xxx。但你会得到一个NameError。原因很简单IPython控制台本质是Python交互环境pip在这里不是一个Python内置变量直接敲会被当成Python代码解析。正确做法是加一个英文感叹号让IPython把这一行当作系统命令执行!python -m pip install pandas在IPython里以!开头的内容会传给底层操作系统去执行。所以我推荐你写成python -m pip install而不是直接!pip install。两者有什么差别直接!pip install调用的是环境变量PATH里找到的那个pip脚本而python -m pip install调用的是当前Python解释器自带的pip模块。在Spyder这种经常对接多个Python环境的场景下第二种写法几乎不会出错它必定装进当前Spyder正在使用的环境里。这是我从多次踩坑中总结出来的铁律。安装完成后你可以在同一个控制台里验证import pandas print(pandas.__version__)如果能正常输出版本号就说明安装成功。3.2 在系统终端或Anaconda Prompt里安装如果你更喜欢传统的命令行窗口那操作方式是在Spyder外部打开终端工具。先激活你Spyder正在使用的那个conda环境。比如Spyder绑定的是base环境conda activate base然后安装python -m pip install openpyxl如果你不确定当前环境是否对应可以再次检查sys.executable一定要确认终端里的Python路径和Spyder的Python路径一致否则就会装到别的环境里造成“明明装成功了Spyder里却import不到”的灵异事件。3.3 通过Spyder自带的“安装/管理包”图形界面在新版Spyder中菜单栏的“工具”里可以找到包管理入口。不同版本位置略有差异常见的是在Tools菜单下选择“Install and manage packages”界面会弹出一个包管理器窗口。这个管理器本质上也是调用pip来实现安装但它简化了操作界面里可以直接输入包名、选择版本、配置镜像源。如果你不习惯命令行用这个界面就好。需要注意的是这里安装的目标环境默认是Spyder当前绑定的环境装之前最好确认一下界面顶部显示的解释器路径别稀里糊涂装进了一个你根本不用的小环境。3.4 我应该用conda install还是pip install这是一个很多新手都会纠结的问题。原则其实很简单conda install适用于conda源里有的包能解决底层的依赖冲突尤其是那些需要编译的库比如numpy、scipy、pandas。pip install适用于conda源里没有的包或者你想装最新版本、或者明确知道包只发布在PyPI上。在实际操作中很多纯Python包用pip装更快、版本更新。但如果底层依赖复杂用conda装会更省心。比如numpy这种你用pip装到某些系统上可能会踩到编译工具的坑而conda直接分发二进制包省去了很多麻烦。我的建议是大数据和科学计算类的核心库优先conda其他边角功能库用pip。两条命令在你的环境里可以共存互相不冲突。4. 给pip配置国内镜像源安装速度快十倍4.1 为什么默认PyPI那么慢一个命令临时换源pip安装第三方库默认是从PyPI官方源下载pypi.org。这个源服务器在国外国内网络访问经常出现连接超时、速度几KB每秒、下载到一半失败的问题。解决办法是换用国内镜像源。常用的有这么几个镜像源地址阿里云https://mirrors.aliyun.com/pypi/simple/清华TUNAhttps://pypi.tuna.tsinghua.edu.cn/simple中科大https://pypi.mirrors.ustc.edu.cn/simple/豆瓣https://pypi.douban.com/simple/临时换源很简单安装时用-i参数指定源即可python -m pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple如果使用的是最新版pip镜像源还支持--index-url的完整形式但日常使用-i这个简写就够了。如果你在配置严格的环境里有时还需要加上信任主机的参数python -m pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn出现SSL证书报错时这个参数能临时绕过证书验证问题但注意这属于降低安全性的做法只建议在可信内网环境使用。4.2 永久配置pip源一劳永逸不折腾如果觉得每次安装都带-i参数太麻烦可以直接把镜像源写进pip的配置文件这样以后pip默认使用国内源。Windows系统下你需要在当前用户的目录下创建一个pip文件夹然后在里面新建pip.ini文件。路径大概是C:\Users\你的用户名\pip\pip.iniLinux或macOS系统需要在用户目录下创建pip.conf文件~/.pip/pip.conf文件内容[global] index-url https://pypi.tuna.tsinghua.edu.cn/simple [install] trusted-host pypi.tuna.tsinghua.edu.cn保存后执行python -m pip config list如果能列出刚才的配置就说明已经生效。以后安装第三方库直接写pip install包名pip会默认从清华源拉取。这里犯懒的人特别多我多说一句配置文件的名字和路径不要写错Windows下是pip.ini不是pip.txt也不是pip.conf。有人建了个pip.conf.ini结果配置半天不生效查了很久才发现文件名的问题。4.3 完全离线安装第三方库从下载到部署有些单位的开发环境是物理隔离的内网不能访问外网。这时候没办法在线安装需要在一台能上网的机器上下载好安装包再拷贝到内网机器上安装。在有网的机器上执行# 创建一个目录存放安装包 mkdir offline_pkgs # 下载包及其所有依赖到指定目录 python -m pip download -d offline_pkgs pandas requests如果项目依赖特别多更推荐用requirements.txt统一管理python -m pip download -d offline_pkgs -r requirements.txt下载完成后把offline_pkgs整个文件夹拷贝到内网机器上。然后在内网机器上执行python -m pip install --no-index --find-linksoffline_pkgs -r requirements.txt这里有两个关键参数--no-index告诉pip不要去远程索引查找只使用本地包。--find-links指定本地包所在目录。离线安装最大的坑在于版本兼容性。pip download下载的包与下载机的Python版本、操作系统位数强相关。比如在Windows Python 3.11上下载的包很可能无法装到Linux Python 3.8上。所以务必使用同架构、同版本甚至同系统类型的机器来执行下载操作。如果你只想安装单个.whl或.tar.gz文件也可以用python -m pip install 包名.whl这种方式不用指定网络源pip直接从本地文件安装也是离线安装的一种补充方式。5. 常见报错与排查记录这些坑我都替你踩过5.1 提示“pip不是内部或外部命令”或“无法将pip识别为cmdlet”这个报错在Windows上极其常见。出现它的原因是pip的脚本目录没有被加入系统环境变量PATH。pip脚本通常位于Python安装目录下的Scripts子目录。比如C:\Users\你的用户名\AppData\Local\Programs\Python\Python311\ScriptsAnaconda环境下则在Anaconda目录下的Scripts目录。解决思路有两个第一个思路是以后都改用python -m pip因为只要你还能运行python这个命令就能正常工作完全不依赖PATH。第二个思路是把这个Scripts目录手动加到PATH里。具体操作为打开“系统属性”中的“环境变量”找到Path在末尾追加Scripts目录地址保存后重启终端工具。我强烈建议你在环境变量问题上有洁癖一点不要一次往PATH里塞一堆目录。加多了以后多版本Python、多个pip并存各种诡异问题会排队来找你。5.2 提示“Fatal error in launcher: Unable to create process using...”这个报错往往发生在多个Python版本共存时。系统里原来装了某个Python的pip后来卸掉了或者更换了解释器的路径pip.exe里记录的Python路径已经失效于是双击或者调用pip时就会提示launcher错误。解决办法是用当前可用的Python解释器强制重装pippython -m pip install --upgrade --force-reinstall pip这条命令会用当前正在执行的python来重建pip脚本让launcher指向正确的Python路径。如果这条命令都执行不了说明当前环境里pip模块也不完整了那就回到第二节先跑python -m ensurepip --upgrade修复基础再升级。5.3 提示“Could not fetch URL https://pypi.org/simple/pip/ ... SSL”这个报错我在公司内网遇到过很多次。原因通常是机器访问internet需要走代理而pip没有配置代理或者某个安全软件拦截了pip的访问请求。结合前面的换源方案最快速的解决办法是换用国内镜像源python -m pip install 包名 -i https://pypi.tuna.tsinghua.edu.cn/simple如果换源依然报SSL错误再检查系统代理设置确认环境变量中HTTP_PROXY和HTTPS_PROXY是否配置正确。如果是在公司网络环境去掉代理配置或者放行pypi.org域名往往就能解决。如果暂时不需要访问网络只是想安装本地包用刚才提到的离线安装命令即可绕过网络检查。5.4 pip提示“You are using pip version 20.3.1; however, version 25.0.1 is available”这个提示不是报错纯粹是好心提醒你pip有新版。但如果你是在内网环境每次都会看到它还挺烦人的。可以执行升级python -m pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple如果升级不了或者在离线环境也可以忽略这个提示不影响你安装其他包。或者设置环境变量PIP_DISABLE_PIP_VERSION_CHECK1来关闭这个检查。5.5 包明明装成功了Spyder里就是import不到这个问题出现的频率极高原因几乎永远只有一个pip安装时使用的Python环境和Spyder当前绑定的Python环境不是同一个。比如你在终端里执行pip install装到了系统自带的Python环境而Spyder绑定的是Anaconda的base环境。包确实装成功了但装在了一个Spyder根本不会用到的环境里当然import不到。排查步骤在Spyder的IPython控制台运行import sys; print(sys.executable)记下路径A。打开终端运行python -c import sys; print(sys.executable)记下路径B。对比A和B如果不同说明两个环境确实不一致。解决办法是让Spyder切换到pip安装时使用的那个环境或者在Spyder环境里重新安装这个包。在Spyder中切换环境的方法是菜单栏“工具” - “偏好设置” - “Python解释器”然后选择“使用以下解释器”把路径指向你想要的那个Python。我在实际使用中还碰到过一种隐蔽的情况Spyder的IPython console是在旧环境里打开的我改了Spyder的解释器配置但控制台没重启。这时候需要点控制台右上角的“重启内核”Python环境才会真正刷新。5.6 常见问题速查表报错原话原因解决动作pip 不是内部或外部命令pip脚本不在PATH改用python -m pip或把Scripts目录加入PATHNo module named pip环境里没有pippython -m ensurepip --upgrade或get-pip.pyFatal error in launcherpip入口脚本绑定的Python失效python -m pip install --upgrade --force-reinstall pipCould not fetch URL ... SSL网络无法访问PyPI换国内镜像源或配置代理pip is not recognized ... cmdletPowerShell里pip不可用使用python -m pip命令import不了刚装的包环境不一致重启Spyder内核核对sys.executable路径最后说点个人体会写了这么多其实核心就一句话用pip之前先弄清楚你当前是哪个Python环境然后用python -m pip这个姿势去安装基本能避开九成以上的坑。剩下的就是镜像源问题国内直接永久配置清华源你会发现pip install的体验瞬间从“煎熬”变成“丝滑”。我再分享一个小技巧每次装完一个库我习惯在Spyder的IPython控制台里多敲一步验证——import这个库然后打印版本号。这样做成本极低但能第一时间发现装进错误环境的问题比等到写代码时才发现import失败要省心得多。如果你正在Spyder环境里折腾pip希望这篇东西能让你少走点弯路。能顺利装上库、写出自己的代码这比什么都强。