首页/资讯中心/详情

51_Python环境搭建与第一个程序

51_Python环境搭建与第一个程序
📅 发布时间：2026/6/23 1:59:35

Python环境搭建与第一个程序

文章目录

  • Python环境搭建与第一个程序
    • 前言
    • 一、Python的下载与安装
      • 1.1 下载Python
      • 1.2 Windows安装步骤
      • 1.3 macOS与Linux安装
    • 二、选择你的IDE（集成开发环境）
      • 2.1 VS Code（推荐）
      • 2.2 PyCharm
      • 2.3 Jupyter Notebook
      • 2.4 IDLE
    • 三、pip包管理器
      • 3.1 验证pip是否可用
      • 3.2 pip常用命令
      • 3.3 使用国内镜像源加速
    • 四、虚拟环境（venv）
      • 4.1 创建和使用虚拟环境
      • 4.2 为什么要用虚拟环境？
    • 五、第一个Python程序：Hello World
      • 5.1 交互式运行
      • 5.2 编写.py脚本文件
      • 5.3 代码解析
    • 六、常见问题与排错
      • 6.1 "python不是内部或外部命令"
      • 6.2 权限不足（Permission Denied）
      • 6.3 编码问题
    • 总结
    • ✅ 亮点总结
    • 适用场景
    • 扩展方向

前言

Python 作为目前最受欢迎的编程语言之一，以其简洁优雅的语法和强大的生态体系，广泛应用于Web开发、数据分析、人工智能、自动化运维等领域。对于初学者而言，迈出学习Python的第一步就是要搭建好开发环境并写出第一个程序。在开始之前，有一个现实问题需要正视：很多新手在安装阶段就遇到了各种报错，比如"python不是内部或外部命令"、pip安装超时、虚拟环境创建失败等等。这些问题看似琐碎，却很容易让初学者产生挫败感。

本文将手把手带你完成Python的安装、IDE的配置、pip包管理器的使用、虚拟环境的创建，最终运行属于你的第一个Python程序——经典的Hello World。文章涵盖了Windows、macOS和Linux三大操作系统的安装步骤，并对每个环节可能遇到的坑做了特别标注，让你在搭建环境时少走弯路。

无论你是完全零基础的编程新手，还是从其他语言转过来的开发者，这篇文章都能帮你快速搭建Python开发环境。环境搭好了，后面的学习才能事半功倍。

一、Python的下载与安装

1.1 下载Python

打开浏览器，访问Python官方网站：https://www.python.org/downloads/

你会看到醒目的大按钮，推荐下载最新稳定版本。截至2024年，推荐下载Python 3.12.x或更高版本。

注意：请务必下载Python 3.x版本，Python 2.x已于2020年停止维护，初学者不应再使用。

1.2 Windows安装步骤

下载完成后，双击安装包，关键一步是勾选底部的“Add Python to PATH”（将Python添加到系统环境变量），这一步非常重要，否则后续在命令行中无法直接使用python命令。

# 勾选Add Python to PATH后，一路Next即可完成安装

验证安装是否成功，打开命令提示符（Win+R，输入cmd回车），输入以下命令：

python--version

如果看到类似Python 3.12.3的输出，说明安装成功。如果提示找不到命令，99%的原因是安装时忘了勾选"Add Python to PATH"。这个问题非常常见，不必慌张，重新运行安装程序勾选该选项即可解决。另外，在某些Linux发行版中，你可能需要输入python3 --version而非python --version，这是因为系统同时保留了Python 2和Python 3的环境。

1.3 macOS与Linux安装

macOS用户可以使用Homebrew安装：

brewinstallpython3

Linux用户（以Ubuntu为例）：

sudoaptupdatesudoaptinstallpython3 python3-pip

安装完成后同样使用python3 --version验证。

二、选择你的IDE（集成开发环境）

好的IDE能大幅提升开发效率。以下是Python开发中最常用的几款工具：

2.1 VS Code（推荐）

VS Code是微软推出的免费轻量级编辑器，安装Python扩展后功能强大。

  1. 下载安装VS Code：https://code.visualstudio.com/
  2. 打开VS Code，点击左侧扩展图标，搜索Python
  3. 安装微软官方的Python扩展
  4. 创建一个.py文件即可开始编码

2.2 PyCharm

JetBrains出品的专业Python IDE，社区版免费且功能完整。适合中大型项目开发。

2.3 Jupyter Notebook

适合数据分析、科学计算场景，可以交互式地运行代码块。安装方式：

pipinstalljupyter jupyter notebook

2.4 IDLE

Python自带的简易编辑器，适合初学者快速验证代码，无需额外安装。

三、pip包管理器

pip是Python的包管理工具，用于安装和管理第三方库。Python 3.4以上版本默认自带pip。

3.1 验证pip是否可用

pip--version# 输出示例：pip 24.0 from C:\Python312\lib\site-packages\pip (python 3.12)

3.2 pip常用命令

以下是最常用的pip命令，掌握这些基本足够了：

# 安装包pipinstallrequests# 安装指定版本pipinstallrequests==2.28.0# 卸载包pip uninstall requests# 查看已安装的包pip list# 导出当前环境的依赖pip freeze>requirements.txt# 从文件批量安装依赖pipinstall-rrequirements.txt# 升级pip自身python-mpipinstall--upgradepip

pip freeze > requirements.txt这行命令在团队协作中尤为重要，它能把当前环境所有依赖包及其版本号写到一个文件中，其他团队成员只需执行pip install -r requirements.txt就能复现完全一致的开发环境。在面试中，关于"如何保证团队开发环境一致"是常见考点，答案就是requirements.txt配合虚拟环境。

3.3 使用国内镜像源加速

国内用户访问PyPI官方源可能较慢，推荐使用清华或阿里云镜像：

# 临时使用pipinstallrequests-ihttps://pypi.tuna.tsinghua.edu.cn/simple# 永久配置（Windows）pip configsetglobal.index-url https://pypi.tuna.tsinghua.edu.cn/simple

四、虚拟环境（venv）

虚拟环境可以隔离不同项目的依赖，避免版本冲突。这是Python开发的最佳实践。

4.1 创建和使用虚拟环境

# Windowspython-m venv myenv myenv\Scripts\activate# macOS/Linuxpython3-m venv myenv source myenv/bin/activate

激活后，你看到的命令行前缀会有(myenv)标识，表示当前工作在虚拟环境中。使用deactivate命令可以退出虚拟环境。

提醒：很多新手会忘记激活虚拟环境就直接pip install，结果包装到了全局环境，导致不同项目之间的依赖互相污染。养成习惯：每次打开终端进入项目后，第一件事就是激活虚拟环境。

4.2 为什么要用虚拟环境？

假设项目A需要Django 3.2，项目B需要Django 4.0。如果全局安装，版本冲突将不可避免。虚拟环境让每个项目拥有独立的Python包空间，互不干扰。

五、第一个Python程序：Hello World

5.1 交互式运行

打开终端，输入python进入交互模式（REPL），看到>>>提示符后输入代码：

>>>print("Hello, World!")Hello,World!

按Ctrl+Z再回车（Windows）或Ctrl+D（macOS/Linux）退出交互模式。

5.2 编写.py脚本文件

创建一个名为hello.py的文件，内容如下。这段代码虽然不长，但涵盖了Python编程中最常见的几种语法元素：函数定义、用户输入、字符串格式化、列表操作和条件判断。

# -*- coding: utf-8 -*-""" 我的第一个Python程序 功能：输出问候语并演示基本语法 """defmain():name=input("请输入你的名字：")print(f"你好，{name}！欢迎来到Python的世界！")# 演示简单的计算a,b=10,20print(f"{a}+{b}={a+b}")# 演示列表操作fruits=["苹果","香蕉","橙子"]print(f"水果篮里有：{', '.join(fruits)}")if__name__=="__main__":main()

在终端中运行：

python hello.py

运行后程序会先让你输入名字，然后输出一系列结果。这个程序中if __name__ == "__main__"是一个非常重要的Python惯用法——它确保了这段代码只有在直接运行hello.py时才会执行，而如果其他模块import hello则不会执行。换句话说，它让同一个文件既能独立运行，又能作为模块被导入复用。

5.3 代码解析

代码元素说明
# -*- coding: utf-8 -*-声明文件编码，支持中文
""" ... """多行注释（文档字符串）
def main():定义函数
input()接收用户输入
f"{变量}"f-string格式化字符串
if __name__ == "__main__"判断是否为主程序入口

六、常见问题与排错

6.1 “python不是内部或外部命令”

这是因为Python没有添加到系统PATH中。解决方法：

  • 重新运行安装程序，勾选"Add Python to PATH"
  • 或者手动将Python安装目录添加到系统环境变量

6.2 权限不足（Permission Denied）

在Linux/macOS上使用系统级pip安装时可能遇到权限问题，使用--user参数：

pipinstall--user包名

或使用虚拟环境（推荐）。

6.3 编码问题

如果输出中文出现乱码，确保文件开头有# -*- coding: utf-8 -*-声明，且文件本身以UTF-8编码保存。在VS Code中，可以点击右下角的编码区域手动选择 “Save with Encoding” → “UTF-8”。此外，Windows命令行默认编码是GBK，如果遇到乱码，可以在命令提示符中输入chcp 65001切换到UTF-8编码。

总结

本文我们从零开始，完成了Python开发环境的完整搭建过程，包括：

  1. 安装Python解释器——注意勾选Add to PATH
  2. 选择并配置IDE——VS Code是最推荐的免费选择
  3. 掌握pip基本使用——安装、卸载、镜像源配置
  4. 理解虚拟环境的重要性——隔离依赖，避免冲突
  5. 编写并运行第一个Python程序——从Hello World到交互式小程序

环境搭建是编程之旅的起点，看似简单但至关重要。一个良好的开发环境能让你在后续的学习中事半功倍。下一篇文章我们将深入学习Python的变量与数据类型，探索Python中如何存储和操作数据。

行动建议：看完本文后，请亲自完成一遍安装流程，并修改Hello World程序，尝试输出更多内容。实践是最好的学习方式！

✅ 亮点总结

  • Python安装与PATH配置：从零完成Windows/macOS/Linux三平台Python安装，理解Add to PATH的关键作用
  • VS Code开发环境：掌握IDE安装、Python插件配置、代码运行与调试的全流程
  • pip包管理器：学会安装/卸载/升级第三方库，配置国内镜像源大幅提升下载速度
  • 虚拟环境（venv）：理解项目级依赖隔离的重要性，避免不同项目间的包版本冲突
  • 第一个Python程序：从Hello World到交互式输入输出，迈出编程实战的第一步

适用场景

  • 新电脑/新系统上搭建Python开发环境，快速进入开发状态
  • 团队项目中统一开发环境配置，确保"在我机器上能跑"不再成为问题
  • 编程教学或培训场景下，帮助学员完成环境准备，降低入门门槛

扩展方向

  • 学习 conda（Anaconda/Miniconda）环境管理，适合数据科学方向
  • 了解 Docker 容器化开发环境，实现"一次构建，处处运行"
  • 推荐继续阅读下一篇：Python变量与数据类型，正式开始Python语法学习之旅