0

0

VSCode中怎么安装pip_VSCode终端安装Python包管理工具pip教程

星夢妙者

星夢妙者

发布时间:2025-08-29 13:05:01

|

946人浏览过

|

来源于php中文网

原创

答案:在VSCode终端安装pip需先确认Python是否已正确安装并配置环境变量。若未安装,可通过python -m ensurepip --default-pip命令或下载get-pip.py脚本运行安装。常见问题是PATH未包含Python的Scripts目录,导致pip无法识别,需手动添加路径或重新安装Python并勾选“Add Python to PATH”。为避免包导入错误,应确保VSCode终端与代码运行使用同一解释器,推荐为每个项目创建独立虚拟环境(python -m venv .venv),激活后在VSCode中选择对应解释器,保证依赖隔离和环境一致性。

vscode中怎么安装pip_vscode终端安装python包管理工具pip教程

在VSCode终端安装

pip
,这事儿吧,听起来简单,但其实很多时候它已经跟着你的Python安装好了。如果真没装上,或者出了点小岔子,最直接的方法通常是确保你的Python安装是完整的,或者利用Python自带的
ensurepip
模块来补装。说白了,就是检查、修复或重新安装Python,顺便把
pip
带上。

解决

pip
在VSCode终端的安装问题,我们得从几个角度来看。

最理想的情况是,当你安装Python时,

pip
就已经默认被安装了。大多数现代Python发行版都会这么做。你可以在VSCode里打开一个终端(
Ctrl+``
View -> Terminal
),然后输入
pip --version
。如果能看到版本信息,恭喜你,
pip
已经就位了。

但如果提示

'pip' is not recognized as an internal or external command
,或者
pip
命令找不到,那我们可能需要手动干预一下。

立即学习Python免费学习笔记(深入)”;

情况一:Python已安装,但

pip
缺失或损坏。 Python 3.4及以上版本自带了一个
ensurepip
模块,专门用来安装
pip
。你可以在VSCode终端里运行这个命令:

python -m ensurepip --default-pip

这个命令会尝试安装

pip
。如果你的
python
命令指向的是正确的Python解释器,这通常就能解决问题。

情况二:完全没有

pip
,或者
ensurepip
也搞不定。
这时候,我们可能需要使用
get-pip.py
脚本。这是一个由
pip
项目官方提供的独立安装脚本。

  1. 下载脚本:浏览器中访问
    https://bootstrap.pypa.io/get-pip.py
    ,然后将页面内容保存为
    get-pip.py
    文件,放到一个你容易找到的目录,比如你的用户根目录或者项目目录。
  2. 运行脚本: 在VSCode终端中,导航到你保存
    get-pip.py
    的目录,然后运行:
    python get-pip.py

    请注意,这里使用的

    python
    命令应该指向你希望安装
    pip
    的那个Python解释器。如果你系统里有多个Python版本,最好用完整的路径,例如
    C:\Python39\python.exe get-pip.py

验证安装: 无论哪种方法,安装完成后,再次在VSCode终端输入

pip --version
。如果成功显示版本号,并且没有报错,那就说明
pip
已经安装并可以正常使用了。记得,有时候环境变量更新需要重启VSCode或者终端才能生效。

Python安装后为什么
pip
还是找不到?这背后可能有哪些坑?

说实话,这挺让人头疼的。明明Python都装好了,

pip
却像个失踪的孩子。这通常不是
pip
没装,而是系统没找到它。

一个最常见的原因是环境变量(PATH)配置不正确。当你安装Python时,安装程序会问你是否要“Add Python to PATH”。如果这个选项没勾选,或者勾选了但因为某些原因没生效,那么你的系统就不知道

pip
命令在哪里。
pip
通常位于Python安装目录下的
Scripts
子目录里。

检查方法:

  1. 找到Python安装路径: 在VSCode终端输入
    where python
    (Windows) 或
    which python
    (macOS/Linux),这会显示Python解释器的路径。然后,你需要手动去这个路径下的
    Scripts
    目录看看有没有
    pip.exe
    (Windows)或
    pip
    (macOS/Linux)。
  2. 检查环境变量:
    • Windows: 搜索“环境变量”,编辑用户或系统变量中的
      Path
      ,确保包含了Python安装路径和其
      Scripts
      子目录的路径。比如
      C:\Python39
      C:\Python39\Scripts
    • macOS/Linux:
      Path
      变量通常在
      .bashrc
      ,
      .zshrc
      ,
      .profile
      等文件中配置。确保有类似
      export PATH="/usr/local/bin:$PATH"
      这样的行,并且
      /usr/local/bin
      或Python安装路径包含
      pip

解决办法:

  • 重新运行Python安装程序: 最省心的方法。卸载当前的Python,然后重新安装,确保在安装向导中勾选了“Add Python to PATH”这个选项。这通常能一劳永逸地解决问题。
  • 手动添加环境变量: 如果不想重装,就手动把Python的安装路径和
    Scripts
    子目录添加到系统的
    Path
    环境变量中。添加后,记得重启VSCode或者打开一个新的终端窗口,让环境变量生效。
  • 使用完整路径调用
    pip
    作为临时的解决方案,你也可以直接使用Python解释器的完整路径来调用
    pip
    ,例如
    C:\Python39\python.exe -m pip install some-package
    。但这终究不是长久之计。

在VSCode中,我该如何优雅地管理不同的Python环境?

在Python开发中,环境管理是个老大难问题,尤其当你同时做几个项目,每个项目依赖的库版本还不一样时。VSCode在这方面做得其实挺不错的,它能很好地支持虚拟环境。

我个人觉得,使用虚拟环境(Virtual Environment)是最佳实践。它能把每个项目的依赖项隔离开,避免“依赖地狱”。Python 3.3+ 自带了

venv
模块,用起来非常方便。

RecoveryFox AI
RecoveryFox AI

AI驱动的数据恢复、文件恢复工具

下载

在VSCode中创建和激活虚拟环境:

  1. 创建虚拟环境: 在VSCode终端中,导航到你的项目根目录,然后运行:
    python -m venv .venv

    .venv
    是虚拟环境的名称,你可以改成其他你喜欢的名字。这会在你的项目目录下创建一个新的文件夹。

  2. 激活虚拟环境:
    • Windows (PowerShell):
      ./.venv/Scripts/Activate.ps1
    • Windows (CMD/Git Bash):
      ./.venv/Scripts/activate
    • macOS/Linux:
      source ./.venv/bin/activate

      激活后,你的终端提示符前会显示虚拟环境的名称(例如

      (.venv)
      ),这表明你当前的操作都在这个独立的环境里。

VSCode选择解释器: 激活虚拟环境后,VSCode的Python扩展通常会自动检测到并建议你使用这个环境的解释器。如果没自动检测,你可以手动选择:

  1. 点击VSCode底部状态栏左侧的Python解释器版本号(例如
    Python 3.9.7
    )。
  2. 在弹出的命令面板中,选择你刚刚创建的虚拟环境中的Python解释器(通常路径会包含
    .venv
    )。

好处:

  • 所有
    pip install
    的包都只会安装到当前激活的虚拟环境中,不会污染系统全局Python。
  • 项目之间依赖隔离,避免版本冲突。
  • 方便项目分享和部署,只需要分享
    requirements.txt
    文件。

我强烈建议,每个Python项目都创建一个独立的虚拟环境,这是保持开发环境整洁和项目可维护性的基石。

为什么在VSCode终端安装的包,在代码里却找不到?

这绝对是新手甚至一些老手都会犯的“坑”。你明明在VSCode终端里

pip install requests
了,结果在你的Python代码里
import requests
却报错
ModuleNotFoundError
。这种体验,简直让人抓狂,感觉自己是不是哪里操作错了。

核心问题在于:VSCode终端使用的Python解释器,和VSCode运行/调试你的代码时使用的Python解释器,可能不是同一个!

想象一下,你家里有两把钥匙,一把开前门,一把开后门。你在前门那头放了东西,却想从后门那头找到。这就是解释器不匹配的典型场景。

具体原因分析:

  1. 终端解释器: 当你在VSCode里打开一个终端时,它默认会使用你系统
    Path
    环境变量中找到的第一个
    python
    命令。这个
    python
    可能指向的是系统全局Python,或者其他某个版本的Python。
  2. VSCode运行/调试解释器: VSCode的Python扩展会有一个独立的配置,决定它在运行、调试你的
    .py
    文件时使用哪个Python解释器。你可以在VSCode底部状态栏看到当前选定的解释器,或者通过
    Ctrl+Shift+P
    搜索
    Python: Select Interpreter
    来查看和选择。

如果这两个解释器不是同一个,那么你在终端里用一个解释器安装的包,在代码里用另一个解释器运行时,自然就找不到那些包了。

解决方案:

  • 统一解释器: 最根本的解决办法是确保VSCode终端和VSCode运行/调试代码时,都使用同一个Python解释器
    1. 激活虚拟环境: 最佳实践是为你的项目创建一个虚拟环境(如上一个副标题所述)。
    2. 在终端中激活虚拟环境: 确保你在VSCode终端里激活了你的虚拟环境。激活后,终端的
      python
      pip
      命令都会指向这个虚拟环境内的解释器和
      pip
    3. VSCode选择虚拟环境解释器: 确保VSCode的Python扩展也选择了这个虚拟环境内的解释器。点击底部状态栏的解释器名称,然后从列表中选择你的虚拟环境解释器。
  • 检查
    sys.executable
    在你的Python代码里,可以加上
    import sys; print(sys.executable)
    来打印当前代码正在使用的Python解释器的路径。然后与你在终端里运行
    where python
    which python
    得到的路径进行对比,看看是不是一致。
  • pip install
    到正确的解释器:
    如果你不想使用虚拟环境(虽然不推荐),至少要确保你在终端里安装包时,使用的是VSCode配置的那个解释器。这可以通过指定解释器路径来完成,例如 `C:\Users\YourUser\AppData

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

339

2023.10.09

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

414

2024.12.20

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

761

2024.12.23

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

349

2025.07.23

python中print函数的用法
python中print函数的用法

python中print函数的语法是“print(value1, value2, ..., sep=' ', end=' ', file=sys.stdout, flush=False)”。本专题为大家提供print相关的文章、下载、课程内容,供大家免费下载体验。

186

2023.09.27

default gateway怎么配置
default gateway怎么配置

配置default gateway的步骤:1、了解网络环境;2、获取路由器IP地址;3、登录路由器管理界面;4、找到并配置WAN口设置;5、配置默认网关;6、保存设置并退出;7、检查网络连接是否正常。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

223

2023.12.07

自建git服务器
自建git服务器

git服务器是目前流行的分布式版本控制系统之一,可以让多人协同开发同一个项目。本专题为大家提供自建git服务器相关的各种文章、以及下载和课程。

724

2023.07.05

git和svn的区别
git和svn的区别

git和svn的区别:1、定义不同;2、模型类型不同;3、存储单元不同;4、是否拥有全局版本号;5、内容完整性不同;6、版本库不同;7、克隆目录速度不同;8、分支不同。php中文网为大家带来了git和svn的相关知识、以及相关文章等内容。

554

2023.07.06

俄罗斯Yandex引擎入口
俄罗斯Yandex引擎入口

2026年俄罗斯Yandex搜索引擎最新入口汇总,涵盖免登录、多语言支持、无广告视频播放及本地化服务等核心功能。阅读专题下面的文章了解更多详细内容。

158

2026.01.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
go语言零基础开发内容管理系统
go语言零基础开发内容管理系统

共34课时 | 2.6万人学习

第二十三期_前端开发
第二十三期_前端开发

共98课时 | 7.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号