如何使用 VS Code 创建 Python 项目

已编辑 2 几天前 通过 ExtremeHow 编辑团队

PythonVisual Studio Code编码工具VS Code集成开发环境项目设置视窗苹果电脑Linux编程工具开发

使用 Visual Studio Code (VS Code) 创建 Python 项目是一个简单易行的过程，它可以极大地帮助初学者和有经验的程序员。VS Code 是微软开发的一个多功能且轻量级的代码编辑器，它支持多种编程语言，尤其是 Python。它提供了调试、任务运行、版本控制等功能，还有一个扩展市场，用于增强你的编码体验。本分步指南将帮助你从头开始使用 VS Code 设置一个 Python 项目。

要求

在我们开始之前，请确保你的电脑上安装了以下先决条件：

• Python 运行时：你需要从 Python 官方网站下载并安装 Python。确保启用了将 Python 添加到系统 PATH 变量的安装选项。
• VS Code：可从 Visual Studio Code 官方网站获得，VS Code 是一个免费的源代码编辑器。
• VS Code 的 Python 扩展：此扩展为 Python 编码提供了所有必要的支持，如 Intellisense（代码自动完成功能）、代码检查和调试等。可以通过 VS Code 扩展市场轻松安装。

安装 VS Code

首先，从官方网站下载适用于你的操作系统的 VS Code 安装程序。按照提供的安装说明进行操作，确保选择了所有必需的组件，尤其是与开发相关的组件。安装完成后，启动 VS Code。

设置 Python 环境

安装 Python

要安装 Python，请访问官方Python 网站并下载适用于你操作系统的安装程序。运行安装程序并选择最适合你的配置选项，确保在提示时将 Python 添加到系统 PATH。

在 VS Code 中安装 Python 扩展

启动 VS Code 并通过点击窗口侧面的活动栏中的扩展图标或使用 Ctrl+Shift+X 快捷键打开扩展视图。在扩展市场中搜索“Python”。点击安装以添加 Microsoft 提供的 Python 扩展。此扩展为编辑器增加了必不可少的 Python 特定功能，这是开发 Python 应用所必需的。

创建一个新的 Python 项目

在设置好 Python 和所需的扩展之后，下一步是创建一个新的 Python 项目。你可以使用 VS Code 通过以下方法完成此操作：

打开新的工作区

VS Code 中的工作区是一个可以管理你的 Python 项目文件的容器。要开始，请打开 VS Code，并从文件菜单中选择“打开文件夹”。在你想要存储 Python 项目文件的目录中创建一个新文件夹。文件夹创建好后，选择它并在 VS Code 中打开。

创建一个 Python 文件

在你的项目文件夹中，创建一个新的 Python 文件。你可以通过在资源管理器视图中点击“新文件”图标（左侧栏中的文件夹/文件）或使用文件菜单并选择“新文件”来做到这一点。将其命名为具有描述性的名称，比如main.py，这将是你编写代码的主 Python 脚本文件。

编写 Python 代码

Python 是一种解释型语言，因此你在创建 Python 文件后可以立即编写并执行你的代码。

编写一个简单的程序

首先，让我们创建一个简单的程序，在控制台中打印“Hello, World!”。这可以通过在你的main.py文件中编写以下代码来完成：

print("Hello, World!")

运行你的 Python 代码

要运行你的 Python 脚本，你有几个选项。最简单的方法是在 VS Code 中直接打开终端。你可以通过在顶部菜单中选择“终端”然后选择“新终端”打开终端。在终端中，确保你位于包含main.py文件的正确目录中，并通过输入命令来执行脚本：

python main.py

如果一切设置正确，它的输出应如下所示：

Hello, World!

使用 VS Code 调试器

VS Code 的一个强大功能是其内置的调试器，它可以用于识别和修复代码中的问题。要使用调试器，请在脚本文件中点击行号左侧的空白处设置一个断点。这将创建一个小红点，指示脚本的执行将在此处停止。

配置调试器

要开始调试，转到活动栏中的调试图标并点击齿轮图标以打开launch.json配置文件。VS Code 将为 Python 项目建议一个默认配置，你可以根据需要进行调整。

示例launch.json配置：

{ "version": "0.2.0", "configurations": [ { "name": "Python: Current File", "type": "python", "request": "launch", "program": "${file}", "console": "integratedTerminal" } ] }

启动调试会话

在设置断点并验证你的调试器配置后，通过按 F5 或点击调试菜单中的“开始调试”选项启动调试器。你的 Python 脚本将运行并在断点处停止执行，让你可以检查变量、逐步执行代码并识别任何问题。

管理 Python 项目依赖项

管理依赖项对任何 Python 项目都很重要，并且可以通过虚拟环境来高效管理。

创建虚拟环境

在你的项目文件夹中，通过在终端中运行以下命令创建一个虚拟环境：

python -m venv venv

此命令将在你的项目文件夹中创建一个名为venv的新目录，该目录包含一个独立的 Python 安装以及其他脚本和可执行文件。将你的依赖项与系统上安装的全局包分开是一个最佳实践。

激活虚拟环境

要激活虚拟环境，运行：

• 对于 Windows:

  .\venv\Scripts\activate

• 对于 MacOS/Linux:

  source venv/bin/activate

激活后，你的终端提示符应该反映出活动的环境，通常在命令行前加上(venv)。

使用 pip 安装包

激活虚拟环境后，你可以使用 pip 安装包。例如，如果你的项目需要numpy包，可以用以下命令安装：

pip install numpy

要将当前环境依赖项冻结到requirements.txt文件中以提交到你的版本控制库，使用：

pip freeze > requirements.txt

以后任何有项目访问权限的人都可以通过运行pip install -r requirements.txt来安装依赖项。

使用 Git 版本控制

Git 是管理代码版本和与他人合作的必要工具。VS Code 具有内置的 Git 支持，使其易于跟踪更改和在项目上协作。

初始化 Git 仓库

要在项目文件夹中初始化一个 Git 仓库，请在 VS Code 中打开终端并输入：

git init

该命令将在项目目录中创建一个新的 Git 仓库。你的项目文件夹现在包含一个.git目录，该目录默认是隐藏的。

进行第一次提交

初始化仓库后，通过暂存任何更改并提交它们来进行第一次提交。使用以下命令：

git add . 
git commit -m "Initial commit"

第一个命令暂存所有文件，第二个命令用消息“Initial commit”提交。

使用源代码控制视图

VS Code 提供了一个直观的 UI 用于 Git 操作。通过点击活动栏中的源代码控制图标来查看更改列表、暂存更改，并使用 VS Code 界面进行提交。

总结

Visual Studio Code 提供了一个高度集成的开发环境，支持 Python 项目的整个生命周期，从编写和运行代码到调试、管理依赖项和版本控制。

本指南涵盖了安装 VS Code、设置 Python、创建项目工作区、编写和执行代码、使用调试工具、用虚拟环境管理依赖项以及集成 Git 版本控制。通过有效利用这些工具，你可以简化开发、测试和部署 Python 应用的过程，提高个人和协作编程的效率。

  分享本文

如果你发现文章内容有误, 您可以 请求更新