VS Code 安装与 Python 开发环境配置

上一篇已经完成了 Python 的安装，这一篇继续配置写 Python 代码的工具：VS Code。

VS Code 是一个常用的代码编辑器，适合用来学习和编写 Python 程序。它本身不是 Python，但可以通过安装 Python 插件，让我们更方便地写代码、运行代码和查看错误提示。

一、下载安装 VS Code

#

首先进入 VS Code 官网，下载适合自己电脑系统的版本。

常见系统包括：

• Windows
• macOS
• Linux

下载完成后，按照安装程序提示一步一步安装即可。

如果是 Windows 系统，安装过程中可以勾选一些常用选项，比如：

• 添加到 PATH
• 添加“通过 Code 打开”到右键菜单
• 创建桌面快捷方式

这些选项不是必须的，但勾选后使用起来会更方便。

安装完成后，打开 VS Code。

二、安装 Python 插件

#

打开 VS Code 后，点击左侧的“扩展”按钮。

也可以使用快捷键：

Ctrl + Shift + X

在搜索框中输入：

Chinese
# 安装中文语言包（安装完成后点右下角弹出的重启，或者手动重启）

Python
# 安装Python插件

Python 插件可以让 VS Code 支持 Python 代码提示、运行、调试和解释器选择。

安装完成后，VS Code 就具备了基本的 Python 开发能力。

三、创建 Python 学习文件夹

#

建议单独创建一个文件夹，用来存放 Python 学习代码。

例如可以创建一个文件夹：

python-study

然后在 VS Code 中打开这个文件夹：

File → Open Folder

或者中文版界面中选择：

文件 → 打开文件夹

打开文件夹后，可以在左侧文件区域新建一个 Python 文件：

hello.py

注意：Python 文件的后缀是 .py。

四、选择 Python 解释器

#

Python 解释器可以理解为“运行 Python 代码的程序”。

VS Code 只是写代码的地方，真正运行代码的还是 Python 解释器。

如果 VS Code 自动弹出选择解释器的提示，直接选择你已经安装好的 Python 版本即可。

也可以手动选择：

Ctrl + Shift + P

然后输入：

Python: Select Interpreter

接着选择你电脑中已经安装好的 Python 版本。

如果能看到类似这样的选项：

Python 3.14.6

就可以选择它。

五、写第一个 Python 文件

#

打开刚才创建的 hello.py 文件，输入下面的代码：

print("Hello, Python!")

这行代码的作用是输出一段文字。

六、运行 Python 文件

#

运行 Python 文件有两种常见方式。

方法一：点击运行按钮

#

打开 hello.py 文件后，点击右上角的运行按钮。

运行后，下方终端会显示：

Hello, Python!

如果能看到这行内容，说明 VS Code 的 Python 环境已经配置成功。

方法二：使用终端运行

#

也可以在 VS Code 下方终端中输入命令运行。

Windows 可以使用：

python hello.py

macOS 或 Linux 可以使用：

python3 hello.py

运行成功后，同样会看到：

Hello, Python!

七、常见问题

#

1. VS Code 找不到 Python

#

可以先确认电脑是否已经安装 Python。

在终端输入：

python --version

或者：

python3 --version

如果能显示 Python 版本，说明 Python 已经安装成功。

然后回到 VS Code，重新选择解释器：

Ctrl + Shift + P → Python: Select Interpreter

2. 运行按钮没有出现

#

可能是 Python 插件没有安装成功，或者当前文件不是 .py 文件。

可以检查两点：

• 是否安装了 Microsoft 发布的 Python 插件
• 文件名是否以 .py 结尾

例如：

hello.py

不要写成：

hello.txt

3. 终端提示 python 不是命令

#

这种情况通常说明系统没有正确识别 Python 命令。

可以尝试：

py hello.py

或者：

python3 hello.py

如果还是不行，需要回到 Python 安装部分，检查是否正确安装 Python，或者是否配置了环境变量。

4. 代码没有输出结果

#

先检查代码是否写对：

print("Hello, Python!")

注意：

• print 后面要有小括号
• 输出的文字要放在引号里面
• 符号尽量使用英文符号

八、总结

#

这篇文章主要完成了 VS Code 的安装和 Python 开发环境配置。

主要步骤包括：

1. 安装 VS Code
2. 安装 Python 插件
3. 创建 Python 学习文件夹
4. 新建 .py 文件
5. 选择 Python 解释器
6. 运行第一个 Python 程序

完成这些步骤后，就可以正式使用 VS Code 学习 Python 了。