编程马·菜鸟教程

Appearance

第2章：Python 环境搭建 ​

2.1 基础环境准备 ​

Python是跨平台的编程语言，可以在Windows、Mac和Linux等操作系统上运行。下面我们分别介绍不同系统的安装方法。

Windows系统 ​

  1. 下载Python安装包

    • 访问Python官方网站
    • 选择适合Windows系统的Python版本（新手推荐3.9-3.11版本）
    • 点击下载按钮，获取安装程序

  2. 安装Python

    • 双击下载的安装程序
    • 勾选"Add Python to PATH"选项（非常重要，这会将Python添加到系统环境变量中）
    • 点击"Install Now"进行默认安装，或选择"Customize installation"进行自定义安装
    • 安装完成后，点击"Close"关闭安装程序

  3. 验证安装

    • 打开命令提示符（按下Win+R，输入cmd，回车）
    • 输入python --version，如果显示Python版本号，则安装成功
    • 输入pip --version，验证pip（Python包管理工具）是否安装成功

  4. 环境变量配置

    • 如果安装时没有勾选"Add Python to PATH"，需要手动配置环境变量
    • 右键点击"此电脑"，选择"属性" → "高级系统设置" → "环境变量"
    • 在"系统变量"中找到"Path"，点击"编辑"
    • 点击"新建"，添加Python的安装路径（如C:\Python39\）和Scripts目录（如C:\Python39\Scripts\）
    • 点击"确定"保存配置

Mac系统 ​

  1. 使用brew命令安装

    • 打开终端
    • 输入brew install python，等待安装完成

  2. 手动安装

    • 访问Python官方网站
    • 选择适合Mac系统的Python版本
    • 下载并双击安装程序，按照提示完成安装

  3. 验证安装

    • 打开终端
    • 输入python3 --version，如果显示Python版本号，则安装成功
    • 输入pip3 --version，验证pip是否安装成功

  4. 版本切换

    • 如果系统中存在多个Python版本，可以使用python3.x命令指定版本（如python3.9）
    • 也可以使用工具如pyenv来管理多个Python版本

Linux系统 ​

  1. 使用包管理器安装

    • Ubuntu/Debian系统：输入sudo apt update && sudo apt install python3 python3-pip
    • CentOS/RHEL系统：输入sudo yum install python3 python3-pip

  2. 验证安装

    • 打开终端
    • 输入python3 --version，如果显示Python版本号，则安装成功
    • 输入pip3 --version，验证pip是否安装成功

  3. 环境配置

    • Linux系统通常会默认安装Python，但是版本可能较旧
    • 可以使用包管理器安装指定版本的Python

2.2 编程工具准备 ​

选择合适的编程工具可以大大提高编程效率，以下是推荐的Python编程工具：

新手首选：PyCharm ​

  • 特点：社区版免费，功能强大，适合新手入门，界面直观
  • 下载地址：JetBrains PyCharm
  • 优势：
    • 智能代码补全
    • 语法高亮
    • 错误提示
    • 调试功能
    • 版本控制集成

基础工具：Python 自带IDLE ​

  • 特点：简单易用，无需额外安装，适合入门练习
  • 获取方式：安装Python时会自动安装
  • 优势：
    • 轻量级
    • 内置Python解释器
    • 适合简单代码测试

备用工具：VS Code ​

  • 特点：轻量，需安装Python插件，适合有基础后切换
  • 下载地址：Visual Studio Code
  • 优势：
    • 跨平台
    • 插件丰富
    • 界面美观
    • 支持多种编程语言

2.3 工具安装与基础操作 ​

PyCharm ​

  1. 安装

    • 下载并运行安装程序
    • 选择安装路径和组件
    • 完成安装后启动PyCharm

  2. 新建项目

    • 启动PyCharm后，点击"New Project"
    • 选择项目路径和Python解释器
    • 点击"Create"创建项目

  3. 新建Python文件

    • 在项目中右键点击，选择"New" → "Python File"
    • 输入文件名，点击"OK"

  4. 编写代码

    • 在文件中输入Python代码
    • PyCharm会自动进行语法高亮和错误提示

  5. 运行代码

    • 右键点击编辑区域，选择"Run '文件名'"
    • 或使用快捷键Shift+F10

  6. 调试代码

    • 在代码行号处点击，设置断点
    • 右键点击编辑区域，选择"Debug '文件名'"
    • 使用调试工具查看变量值和执行流程

IDLE ​

  1. 启动

    • Windows：在开始菜单中搜索"IDLE"
    • Mac：在应用程序中找到"IDLE"
    • Linux：在终端中输入idle3

  2. 新建文件

    • 点击"File" → "New File"
    • 或使用快捷键Ctrl+N

  3. 编写代码

    • 在文件中输入Python代码

  4. 运行代码

    • 点击"Run" → "Run Module"
    • 或使用快捷键F5

  5. 基础调试

    • IDLE提供基本的调试功能，可以通过"Debug"菜单访问

核心操作 ​

  1. 代码缩进

    • Python使用缩进来区分代码块，通常使用4个空格或1个Tab键
    • 保持缩进一致，避免语法错误

  2. 注释编写

    • 使用#进行单行注释
    • 使用''' '''或""" """进行多行注释
    • 注释应该简洁明了，说明代码功能

  3. 错误排查

    • 仔细阅读错误信息，定位错误位置
    • 检查缩进是否正确
    • 检查语法是否正确
    • 检查变量名是否拼写正确

2.4 环境验证 ​

为了确保Python环境正常运行，我们可以运行第一个Python程序来验证：

  1. 创建测试文件
    • 创建一个名为test.py的文件
    • 写入以下代码：
python
# 打印"Hello Python"
print("Hello Python")

# 打印Python版本
import sys
print("Python版本:", sys.version)

# 打印当前日期
import datetime
print("当前日期:", datetime.datetime.now())

  1. 运行测试文件

    • 使用命令行：python test.py
    • 或使用IDE运行

  2. 检查输出

    • 如果看到类似以下输出，则环境配置成功：
Hello Python
Python版本: 3.9.10 (tags/v3.9.10:f2f3f53, Jan 17 2022, 15:14:21) [MSC v.1929 64 bit (AMD64)]
当前日期: 2023-07-01 10:00:00.123456

2.5 常用基础配置 ​

修改字体大小 ​

  • PyCharm：点击"File" → "Settings" → "Editor" → "Font"，修改字体大小
  • IDLE：点击"Options" → "Configure IDLE" → "Fonts/Tabs"，修改字体大小
  • VS Code：点击"File" → "Preferences" → "Settings"，搜索"font size"，修改字体大小

设置中文界面 ​

  • PyCharm：点击"File" → "Settings" → "Appearance & Behavior" → "Appearance"，选择"UI Language"为中文
  • VS Code：安装中文语言包插件，然后重启VS Code

配置解释器 ​

  • PyCharm：点击"File" → "Settings" → "Project" → "Python Interpreter"，选择或添加Python解释器
  • VS Code：点击左下角的Python版本，选择或添加Python解释器

2.6 常见环境问题排查 ​

安装失败 ​

  • 问题：安装程序无法运行或安装过程中出错
  • 解决方案：
    • 检查系统是否满足Python的最低要求
    • 下载与系统匹配的Python版本
    • 以管理员身份运行安装程序
    • 关闭防火墙和杀毒软件后重试

环境变量配置错误 ​

  • 问题：在命令行中输入python命令提示"未找到命令"
  • 解决方案：
    • 重新安装Python，勾选"Add Python to PATH"
    • 手动配置环境变量，添加Python安装路径
    • 重启命令提示符后重试

代码运行报错 ​

  • 问题：运行Python代码时出现语法错误或运行时错误
  • 解决方案：
    • 检查代码语法是否正确
    • 检查缩进是否一致
    • 检查变量名是否拼写正确
    • 检查导入的模块是否已安装

版本不兼容 ​

  • 问题：代码在不同Python版本下运行结果不同
  • 解决方案：
    • 明确指定Python版本
    • 使用兼容多个版本的代码写法
    • 使用虚拟环境隔离不同项目的依赖

通过以上步骤，你应该已经成功搭建了Python开发环境，为后续的学习做好了准备。如果遇到问题，可以参考官方文档或搜索相关解决方案。

© 2026 编程马·菜鸟教程 版权所有

基于 VitePress 构建