当前位置：首页 > news >正文

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

news 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扩展后功能强大。

下载安装VS Code：https://code.visualstudio.com/
打开VS Code，点击左侧扩展图标，搜索Python
安装微软官方的Python扩展
创建一个.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编码。