如何在 Visual Studio Code 中安装 Python 库
Python 库是开发者的必备工具。它们包含预构建的代码(函数和模块),使编码更加轻松快捷。库有助于解决常见问题,并使开发者能够高效地构建复杂的应用程序。
Visual Studio Code (VS Code) 是一款流行的 Python 开发代码编辑器。它以其多功能性、丰富的扩展程序和易于使用的界面而闻名。这些特性使 VS Code 成为管理和使用 Python 库的理想选择。
本指南将向您展示如何使用 VS Code 有效地安装和管理 Python 库。
先决条件
在 VS Code 中安装 Python 库之前,请确保您已准备好必要的工具:
安装 Python
-
请前往Python官方网站下载最新版本。
-
运行安装程序并按照屏幕上的说明进行操作。安装过程中务必勾选“将 Python 添加到 PATH”复选框。这样您就可以轻松地从终端或命令提示符中使用 Python。
安装 Visual Studio Code:
-
访问VS Code 官方网站,下载适用于您操作系统的安装程序。
-
运行安装程序并按照安装向导安装 VS Code。
安装 Python 扩展:
-
启动 VS Code。
-
点击左侧活动栏中的扩展图标(看起来像四个方块)或按
Ctrl+Shift+X(或CMD+Shift+X在 macOS 上)。 -
在应用商店中搜索“Python”,并安装官方的微软Python扩展。
-
如果出现提示,请重新启动 VS Code 以确保扩展程序已加载并可以使用。
设置 Python 环境
你可以把 Python 环境想象成一个独立的空间,用来存放你的项目及其库。它就像一个专用的工具箱,你可以把所有需要的东西都整理好,并与其他项目隔离开来。
这一点至关重要,因为不同的项目通常需要同一库的不同版本。
虚拟环境是一种特殊的 Python 环境,它将项目库与其他项目隔离,从而避免冲突,提高项目的可靠性。
在 VS Code 中创建虚拟环境
VS Code 让创建这些虚拟环境变得非常简单。现在,让我们来看看如何创建一个虚拟环境:
-
打开终端:在 VS Code 中,转到菜单栏并单击“终端”,然后单击“新建终端”。这会在 VS Code 中打开一个终端窗口。
-
转到您的项目文件夹:如果您尚未进入此文件夹,请使用
cd命令导航到您的项目所在的文件夹。 -
创建环境:输入以下命令并按
ENTER:$ python -m venv env上述命令会
env在项目目录中创建一个名为 `<folder_name>` 的新文件夹。该文件夹将存放您的虚拟环境以及您为项目安装的所有库。
激活虚拟环境
现在,你需要“激活”虚拟环境,告诉 Python 使用它。这很简单:
-
在终端中:根据您的操作系统,输入以下命令:
在Windows系统上:
$ .\\env\\Scripts\\activate在 macOS 和 Linux 系统上:
$ source env/bin/activate -
检查提示符:您的终端提示符现在应该在括号中显示您的环境名称(例如,
(env)),以表明它处于活动状态。
您使用安装的任何 Python 库pip都将放置在您的虚拟环境中,从而保持您的项目井然有序且无冲突。
使用集成终端安装 Python 库
虚拟环境激活后,现在是时候安装那些能让 Python 功能更强大的库了!VS Code 内置的终端让这一切变得非常简单,你无需离开编辑器。
首先,点击顶部菜单中的“终端”,然后选择“新建终端”。VS Code 中会弹出一个终端窗口。
使用以下方式安装库pip
打开终端后,我们将使用pipPython 的包安装程序。它就像你的 Python 库个人购物车。
我们来看一个基本命令:
$ pip install <library_name>
你只需要将 替换<library_name>成你想要的库的名称即可。
例如,您可以使用以下命令安装 Numpy(一个用于数值计算和数组处理的库):
$ pip install numpy
此外,您还可以安装 Pandas,它用于数据处理和分析,安装命令如下:
$ pip install pandas
pip将会找到您请求的库,下载它,并将其直接安装到您的虚拟环境中。
验证安装
要验证您使用pip以下命令安装的库:
$ pip list
此命令将显示所有已安装的库及其版本列表。然后,您需要逐一检查列表,确保所需的库都已安装。
使用以下方式管理图书馆requirements.txt
该requirements.txt文件列出了项目的所有依赖项,方便共享和安装所需的库。
此文件确保参与该项目的每个人都使用相同的库版本,这有助于保持一致性并避免兼容性问题。
如何创建和使用requirements.txt
让我们来看看如何创建并将其用于requirements.txt您的项目中:
-
创建列表:在 VS Code 中,打开终端(在已激活的虚拟环境中),然后运行以下命令:
$ pip freeze > requirements.txt这会
requirements.txt在你的项目文件夹中创建一个文件,并将所有已安装的库及其版本填充到该文件中。 -
从列表中安装:要在新的环境(或不同的计算机上)安装相同的库,请在该环境中打开终端并运行:
$ pip install -r requirements.txtpip它会读取文件并为你安装所有程序。
例如,假设您为项目安装了 Numpy 和 Pandas。您的requirements.txt文件将类似于:
numpy==1.23.5
pandas==1.5.1
该==部分指示pip要安装这些确切的版本。
现在,任何拥有你requirements.txt文件的人都可以在几秒钟内设置出与你相同的环境。
使用 Visual Studio Code 界面进行库管理
Visual Studio Code 提供了多种扩展程序,可帮助用户直接通过界面管理 Python 库。其中一个扩展程序是 Python 环境管理器,它简化了虚拟环境和库的管理过程,无需频繁使用终端。
如何安装和使用扩展程序
让我们一起来看看安装和使用 VS Code 扩展的详细步骤:
-
查找您的扩展:在 VS Code 中打开扩展市场(点击左侧边栏的方形图标,或在 Mac 上按
Ctrl+Shift+X或)。CMD+Shift+X -
安装:搜索“Python 环境管理器”(或其他吸引你的库管理扩展),然后点击“安装”。
-
开始使用
Ctrl+Shift+P:安装完成后,您需要重启 VS Code。然后,通过在命令面板中使用“Python: 选择解释器”命令(或)选择项目的解释器来激活扩展CMD+Shift+P。 -
轻松管理库:现在您可以浏览扩展程序的界面。它通常会显示已安装库的列表。您可以点击库查看详情、更新或删除它。安装新库也很简单,只需按名称搜索并点击“安装”即可。
使用扩展程序管理 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