【Python零基础入门】第2篇：《Python 环境搭建与第一个项目运行》

导语：在上一篇中，我们了解了 Python 的前世今生和核心优势。俗话说“工欲善其事，必先利其器”，今天我们将正式进入实战准备阶段。本篇文章将手把手带你完成 Python 环境的安装、开发工具（IDE）的选择与配置，并亲手运行你的第一个 Python 项目！

一、安装 Python 解释器

Python 解释器是运行 Python 代码的“引擎”。我们需要先从官网下载并安装它。

1. Windows 系统安装指南

下载安装包：访问 Python 官方网站：https://www.python.org/downloads/ 点击黄色的 "Download Python 3.x.x" 按钮下载安装包。
运行安装程序（⚠️ 核心避坑点）：双击下载的 .exe 文件，在安装界面的最下方，务必勾选 "Add python.exe to PATH"（将 Python 添加到环境变量）！

💡 重点提示：如果不勾选此项，后续在命令行中使用 python 命令时会报错“不是内部或外部命令”。勾选后，点击 "Install Now" 进行默认安装即可。
验证安装：按 Win + R 键，输入 cmd 回车打开命令提示符，输入以下命令：
```
python --version
```
如果输出类似 Python 3.12.x，则说明安装成功！

2. macOS 系统安装指南

下载安装包：同样访问 Python 官网，下载适用于 macOS 的 .pkg 安装包（注意区分 Intel 芯片和 Apple Silicon M1/M2/M3 芯片的版本）。
安装：双击 .pkg 文件，按照提示一直点击“继续”完成安装。
验证安装：打开“终端”（Terminal），输入以下命令：
```
python3 --version
```
(注：在 Mac 系统中，通常使用 python3 命令来调用 Python 3)

二、选择与配置开发工具（IDE）

虽然用系统自带的记事本也能写 Python 代码，但一款优秀的集成开发环境（IDE）能提供代码高亮、自动补全、一键运行等功能，让开发效率翻倍。

目前主流的选择有两款，大家可根据喜好任选其一：

方案 A：VS Code（推荐 🌟）

特点：轻量、免费、插件生态极其丰富、界面现代。

下载：前往 VS Code 官网下载并安装。
配置 Python 插件：
- 打开 VS Code，点击左侧活动栏的“扩展”图标（或按 Ctrl+Shift+X）。
- 在搜索框输入 Python。
- 找到由 Microsoft 官方提供的 Python 插件，点击 Install（安装）。
- 安装完成后，VS Code 就具备了完美的 Python 开发能力。

方案 B：PyCharm Community（社区版）

特点：专为 Python 打造、开箱即用、功能强大（但相对较重）。

下载：前往 JetBrains 官网下载 Community（社区版），它是免费且开源的。
安装：一路 Next 完成安装。打开后新建一个 Project，它会自动为你配置好 Python 环境。

三、动手时刻：编写并运行第一个项目

环境搭好了，让我们写一个比 "Hello World" 稍微有趣一点的程序：个人名片生成器。

1. 创建项目文件

在你的电脑上新建一个文件夹，命名为 Python_Learning。在该文件夹下新建一个文本文件，将其重命名为 main.py（注意后缀必须是 .py）。

2. 编写代码

用 VS Code 或 PyCharm 打开 main.py，输入以下代码：

# -*- coding: utf-8 -*-
# 这是一个简单的个人名片生成程序

print("=" * 30)
print(" " * 8 + "我的个人名片")
print("=" * 30)

# 定义一些基本信息
name = "张三"
age = 22
occupation = "Python 开发工程师"
skills = ["Python", "MySQL", "Linux"]

# 打印名片内容
print(f"姓名：{name}")
print(f"年龄：{age} 岁")
print(f"职业：{occupation}")
print(f"技能：{', '.join(skills)}")
print("=" * 30)

# 与用户进行简单交互
user_name = input("请输入你的名字，让我为你打个招呼：")
print(f"你好，{user_name}！欢迎来到 Python 的世界！")

3. 运行程序

方式一：在 IDE 中运行（推荐）

VS Code：点击代码编辑器右上角的“三角形”运行按钮，或者在终端输入 python main.py。
PyCharm：右键点击代码编辑区，选择 Run 'main'，或者点击右上角的绿色三角形。

方式二：在命令行中运行 打开终端/命令提示符，使用 cd 命令进入你的项目文件夹，然后执行：

# Windows
cd C:\你的路径\Python_Learning
python main.py

# macOS/Linux
cd ~/你的路径/Python_Learning
python3 main.py

🎉 预期运行结果：

==============================
        我的个人名片
==============================
姓名：张三
年龄：22 岁
职业：Python 开发工程师
技能：Python, MySQL, Linux
==============================
请输入你的名字，让我为你打个招呼：李四
你好，李四！欢迎来到 Python 的世界！

四、新手避坑指南（常见问题排查）

在环境搭建和运行过程中，新手常会遇到以下三个“拦路虎”，这里提前给出解决方案：

🚨 坑 1：提示“python 不是内部或外部命令”

原因：安装时忘记勾选 "Add to PATH"。解决：

卸载 Python 重新安装，记得勾选。
或者手动配置环境变量：将 Python 的安装路径（如 C:\Users\xxx\AppData\Local\Programs\Python\Python312 和 ...\Scripts）添加到系统的 Path 环境变量中。

🚨 坑 2：代码中的中文打印出来是乱码

原因：文件编码格式不是 UTF-8。解决：

在 VS Code 中，点击右下角的编码格式（如 GBK），选择 "Save with Encoding"，然后选择 UTF-8。
确保代码第一行加上 # -*- coding: utf-8 -*-（虽然 Python 3 默认是 UTF-8，但加上是个好习惯）。

🚨 坑 3：使用 pip 安装第三方库时速度极慢或超时

原因：默认的 PyPI 官方源在国外。解决：配置国内镜像源。在命令行执行以下命令（以清华源为例）：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

五、本篇小结与下期预告

📝 核心知识点回顾

安装 Python 时，务必勾选 "Add to PATH"。
推荐新手使用 VS Code 搭配 Python 插件，或直接使用 PyCharm 社区版。
Python 脚本文件的后缀名必须是 .py，通过 python 文件名.py 命令执行。

🚀 下期预告

环境已经就绪，接下来我们将正式进入 Python 语法的学习。在《第3篇：变量、数据类型与基本运算》中，我们将：

学习什么是变量，以及 Python 的“动态类型”特性。
掌握整数、浮点数、字符串、布尔值等基础数据类型。
学习如何进行类型转换和基本的数学运算。

💬 互动时间：你在安装环境或运行第一个项目时遇到了什么问题吗？或者你使用的是哪款 IDE？欢迎在评论区留言，博主会逐一解答！

本文属于【Python零基础入门】系列教程，欢迎关注博主，订阅专栏，带你从零开始系统掌握 Python！

第2篇：《Python 环境搭建与第一个项目运行》