发布于 2026-01-05 1 阅读
0

如何在 Visual Studio Code 中安装 Python 库

如何在 Visual Studio Code 中安装 Python 库

Python 库是开发者的必备工具。它们包含预构建的代码(函数和模块),使编码更加轻松快捷。库有助于解决常见问题,并使开发者能够高效地构建复杂的应用程序。

Visual Studio Code (VS Code) 是一款流行的 Python 开发代码编辑器。它以其多功能性、丰富的扩展程序和易于使用的界面而闻名。这些特性使 VS Code 成为管理和使用 Python 库的理想选择。

本指南将向您展示如何使用 VS Code 有效地安装和管理 Python 库。

先决条件

在 VS Code 中安装 Python 库之前,请确保您已准备好必要的工具:

安装 Python

  1. 请前往Python官方网站下载最新版本。

  2. 运行安装程序并按照屏幕上的说明进行操作。安装过程中务必勾选“将 Python 添加到 PATH”复选框。这样您就可以轻松地从终端或命令提示符中使用 Python。

安装 Visual Studio Code:

  1. 访问VS Code 官方网站,下载适用于您操作系统的安装程序。

  2. 运行安装程序并按照安装向导安装 VS Code。

安装 Python 扩展:

  1. 启动 VS Code。

  2. 点击左侧活动栏中的扩展图标(看起来像四个方块)或按Ctrl+Shift+X(或CMD+Shift+X在 macOS 上)。

  3. 在应用商店中搜索“Python”,并安装官方的微软Python扩展。

  4. 如果出现提示,请重新启动 VS Code 以确保扩展程序已加载并可以使用。

设置 Python 环境

你可以把 Python 环境想象成一个独立的空间,用来存放你的项目及其库。它就像一个专用的工具箱,你可以把所有需要的东西都整理好,并与其他项目隔离开来。

这一点至关重要,因为不同的项目通常需要同一库的不同版本。

虚拟环境是一种特殊的 Python 环境,它将项目库与其他项目隔离,从而避免冲突,提高项目的可靠性。

在 VS Code 中创建虚拟环境

VS Code 让创建这些虚拟环境变得非常简单。现在,让我们来看看如何创建一个虚拟环境:

  1. 打开终端:在 VS Code 中,转到菜单栏并单击“终端”,然后单击“新建终端”。这会在 VS Code 中打开一个终端窗口。

  2. 转到您的项目文件夹:如果您尚未进入此文件夹,请使用cd命令导航到您的项目所在的文件夹。

  3. 创建环境:输入以下命令并按ENTER

    $ python -m venv env
    

    上述命令会env在项目目录中创建一个名为 `<folder_name>` 的新文件夹。该文件夹将存放您的虚拟环境以及您为项目安装的所有库。

激活虚拟环境

现在,你需要“激活”虚拟环境,告诉 Python 使用它。这很简单:

  1. 在终端中:根据您的操作系统,输入以下命令:

    在Windows系统上

    $ .\\env\\Scripts\\activate
    

    在 macOS 和 Linux 系统上

    $ source env/bin/activate
    
  2. 检查提示符:您的终端提示符现在应该在括号中显示您的环境名称(例如,(env)),以表明它处于活动状态。

您使用安装的任何 Python 库pip都将放置在您的虚拟环境中,从而保持您的项目井然有序且无冲突。

使用集成终端安装 Python 库

虚拟环境激活后,现在是时候安装那些能让 Python 功能更强大的库了!VS Code 内置的终端让这一切变得非常简单,你无需离开编辑器。

首先,点击顶部菜单中的“终端”,然后选择“新建终端”。VS Code 中会弹出一个终端窗口。

使用以下方式安装库pip

打开终端后,我们将使用pipPython 的包安装程序。它就像你的 Python 库个人购物车。

我们来看一个基本命令:

$ pip install <library_name>
Enter fullscreen mode Exit fullscreen mode

你只需要将 替换<library_name>成你想要的库的名称即可。

例如,您可以使用以下命令安装 Numpy(一个用于数值计算和数组处理的库):

$ pip install numpy
Enter fullscreen mode Exit fullscreen mode

此外,您还可以安装 Pandas,它用于数据处理和分析,安装命令如下:

$ pip install pandas
Enter fullscreen mode Exit fullscreen mode

pip将会找到您请求的库,下载它,并将其直接安装到您的虚拟环境中。

验证安装

要验证您使用pip以下命令安装的库:

$ pip list
Enter fullscreen mode Exit fullscreen mode

此命令将显示所有已安装的库及其版本列表。然后,您需要逐一检查列表,确保所需的库都已安装。

使用以下方式管理图书馆requirements.txt

requirements.txt文件列出了项目的所有依赖项,方便共享和安装所需的库。

此文件确保参与该项目的每个人都使用相同的库版本,这有助于保持一致性并避免兼容性问题。

如何创建和使用requirements.txt

让我们来看看如何创建并将其用于requirements.txt您的项目中:

  1. 创建列表:在 VS Code 中,打开终端(在已激活的虚拟环境中),然后运行以下命令:

    $ pip freeze > requirements.txt
    

    这会requirements.txt在你的项目文件夹中创建一个文件,并将所有已安装的库及其版本填充到该文件中。

  2. 从列表中安装:要在新的环境(或不同的计算机上)安装相同的库,请在该环境中打开终端并运行:

    $ pip install -r requirements.txt
    

    pip它会读取文件并为你安装所有程序。

例如,假设您为项目安装了 Numpy 和 Pandas。您的requirements.txt文件将类似于:

numpy==1.23.5
pandas==1.5.1
Enter fullscreen mode Exit fullscreen mode

==部分指示pip要安装这些确切的版本。

现在,任何拥有你requirements.txt文件的人都可以在几秒钟内设置出与你相同的环境。

使用 Visual Studio Code 界面进行库管理

Visual Studio Code 提供了多种扩展程序,可帮助用户直接通过界面管理 Python 库。其中一个扩展程序是 Python 环境管理器,它简化了虚拟环境和库的管理过程,无需频繁使用终端。

如何安装和使用扩展程序

让我们一起来看看安装和使用 VS Code 扩展的详细步骤:

  1. 查找您的扩展:在 VS Code 中打开扩展市场(点击左侧边栏的方形图标,或在 Mac 上按Ctrl+Shift+X或)。CMD+Shift+X

  2. 安装:搜索“Python 环境管理器”(或其他吸引你的库管理扩展),然后点击“安装”。

  3. 开始使用Ctrl+Shift+P:安装完成后,您需要重启 VS Code。然后,通过在命令面板中使用“Python: 选择解释器”命令(或)选择项目的解释器来激活扩展CMD+Shift+P

  4. 轻松管理库:现在您可以浏览扩展程序的界面。它通常会显示已安装库的列表。您可以点击库查看详情、更新或删除它。安装新库也很简单,只需按名称搜索并点击“安装”即可。

使用扩展程序管理 Python 库

安装 Python 环境管理器扩展后,管理 Python 库将变得更加轻松。您可以直接通过界面创建和激活虚拟环境,从而实现无缝的工作流程。

该扩展程序允许您在不离开 Visual Studio Code 的情况下搜索和安装库。例如,您可以在扩展程序中搜索“Numpy”,然后单击“安装”。这简化了向项目中添加库的过程。

此外,该扩展程序还提供更新或移除库的功能。这确保您可以完全掌控项目的依赖项。这样一来,您就无需记住各种pip命令,从而使库管理更加便捷易用。

常见问题排查

安装 Python 库并非总是一帆风顺。有时你可能会遇到一些小问题。但别担心,大多数问题都很容易解决。

以下是一些常见问题及其解决方法:

安装错误:

  • 检查基本配置:首先,请确保已pip正确安装 Python。另外,确认 Python 已添加到系统 PATH 环境变量中。

  • 权限问题:如果您收到有关没有安装权限的错误提示,请尝试使用以下--user标志:

    $ pip install --user <library_name>
    

    此操作只会为您的用户帐户安装库。

  • 查阅文档:如果您看到无法理解的错误消息,请查阅库的官方文档。

兼容性问题:

  • 版本冲突:有时,库之间无法兼容,因为它们需要同一依赖项的不同版本。最好的办法是使用虚拟环境,将每个项目的库隔离开来。

  • 仔细阅读说明:库文档通常会具体说明它们与哪些其他库的版本兼容。

  • 需求文件来帮忙:在文件中指定库版本,requirements.txt可以确保所有人使用相同的版本,避免冲突。您可以像这样添加版本号:numpy==1.20.3

结论

本指南将为您提供在 Visual Studio Code 中自信地安装、管理和排除 Python 库故障所需的知识和技能。

您已经了解了虚拟环境对于保持项目井然有序的重要性。此外,您也掌握了使用集成终端直接安装库的方法,并发现了扩展程序如何简化工作流程。

有了这些工具,你就能从容应对任何 Python 项目。


感谢阅读!如果您觉得这篇文章对您有帮助(我相信您一定觉得有用😉),或者有任何疑问或发现错误/拼写错误……请在评论区留下您的反馈。

如果你心情不错(我希望如此🙂),或者想鼓励我,可以请我喝杯咖啡(或者一千杯),让我开心一下。:)

此外,欢迎通过 LinkedIn与我联系。

文章来源:https://dev.to/emminex/how-to-install-python-libraries-in-visual-studio-code-38i1