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

 

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

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

一、 安装 Python 解释器

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

1. Windows 系统安装指南

  1. 下载安装包： 访问 Python 官方网站：https://www.python.org/downloads/ 点击黄色的 "Download Python 3.x.x" 按钮下载安装包。

  2. 运行安装程序（⚠️ 核心避坑点）： 双击下载的 .exe 文件，在安装界面的最下方，务必勾选 "Add python.exe to PATH"（将 Python 添加到环境变量）！

    💡 重点提示：如果不勾选此项，后续在命令行中使用 python 命令时会报错“不是内部或外部命令”。勾选后，点击 "Install Now" 进行默认安装即可。

  3. 验证安装： 按 Win + R 键，输入 cmd 回车打开命令提示符，输入以下命令：

    python --version

    如果输出类似 Python 3.12.x，则说明安装成功！

2. macOS 系统安装指南

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

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

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

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

方案 A：VS Code（推荐 🌟）

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

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

方案 B：PyCharm Community（社区版）

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

  1. 下载：前往 JetBrains 官网 下载 Community（社区版），它是免费且开源的。
  2. 安装：一路 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"。 解决：

  1. 卸载 Python 重新安装，记得勾选。
  2. 或者手动配置环境变量：将 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

五、 本篇小结与下期预告

📝 核心知识点回顾

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

🚀 下期预告

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

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

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

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

posted @ 2026-09-18 13:48  奔跑的小蚂蚁9538  阅读(76)  评论(0)    收藏  举报