杰瑞科技汇

Python安装教程,步骤详细吗?

Python 安装全攻略 (超详细图文教程)

本教程将引导你完成从下载、安装到配置开发环境的全过程,让你能够顺利地开始 Python 编程之旅。

Python安装教程,步骤详细吗?-图1
(图片来源网络,侵删)

目录

  1. 第一步:准备工作
    • 1 为什么选择 Python?
    • 2 Python 的两个主要版本:Python 2 vs Python 3
    • 3 下载 Python 安装包
  2. 第二步:在 Windows 上安装 Python
    • 1 运行安装程序
    • 2 关键安装选项(非常重要!)
    • 3 验证安装
    • 4 python 命令无效怎么办?(配置环境变量)
  3. 第三步:在 macOS 上安装 Python
    • 1 使用 Homebrew(推荐方式)
    • 2 从官网下载安装
    • 3 验证安装
  4. 第四步:在 Linux 上安装 Python
    • 1 使用包管理器(Ubuntu/Debian, CentOS/Fedora)
    • 2 验证安装
  5. 第五步:选择和配置代码编辑器
    • 1 为什么需要代码编辑器?
    • 2 推荐编辑器:Visual Studio Code (VS Code)
    • 3 在 VS Code 中配置 Python
  6. 第六步:编写并运行你的第一个 Python 程序
    • 1 创建你的第一个文件 hello.py
    • 2 运行程序
  7. 第七步:常见问题与解决方案
    • 1 安装后提示 'python' 不是内部或外部命令... (Windows)
    • 2 pip 命令无效或找不到
    • 3 如何升级 Python 或 pip?
  8. 第八步:最佳实践建议
    • 1 使用虚拟环境
    • 2 善用包管理器 pip

第一步:准备工作

1 为什么选择 Python?

  • 简单易学:语法清晰,接近自然语言,对初学者非常友好。
  • 功能强大:拥有丰富的标准库和第三方库,能胜任 Web 开发、数据分析、人工智能、自动化脚本等各种任务。
  • 社区庞大:遇到问题时,很容易在网上找到解决方案和帮助。
  • 跨平台:可以在 Windows、macOS、Linux 等多种操作系统上运行。

2 Python 的两个主要版本:Python 2 vs Python 3

  • Python 2:已于 2025 年停止官方支持,它不再更新,且存在一些设计缺陷。除非你维护的是非常老旧的项目,否则请绝对不要从 Python 2 开始学习。
  • Python 3:当前和未来的主流版本,包含了大量的改进和新特性。所有新项目都应该使用 Python 3。

请务必下载并安装 Python 3。

3 下载 Python 安装包

  1. 访问 Python 官方下载页面:https://www.python.org/downloads/
  2. 你会看到最新的稳定版本推荐。"Download Python 3.12.0"。
  3. 根据你的操作系统,点击相应的链接下载安装包。
    • Windows: 下载 .exe 安装程序。
    • macOS: 下载 .pkg 安装包。
    • Linux: 通常使用系统自带的包管理器安装,无需从此页面下载。

第二步:在 Windows 上安装 Python

这是最常见的安装环境,请仔细阅读关键步骤。

1 运行安装程序

找到你下载的 python-3.x.x-amd64.exe 文件,双击运行。

2 关键安装选项(非常重要!)

在安装程序的第一个界面,不要直接点击 "Install Now",请先勾选左下角的 "Add python.exe to PATH"

Python安装教程,步骤详细吗?-图2
(图片来源网络,侵删)

为什么必须勾选这个选项?

  • PATH 是操作系统的一个环境变量,它包含了一系列的目录路径,当你在一个命令行窗口(如 CMD 或 PowerShell)中输入一个命令(如 python)时,系统会去 PATH 变量中列出的所有目录里查找对应的可执行文件。
  • 如果不勾选,你将只能在 Python 安装目录(如 C:\Users\你的用户名\AppData\Local\Programs\Python\Python312)下通过完整的路径来运行 python.exe,非常不便。
  • 强烈建议勾选,这会让你后续使用命令行工具(如 pip)变得非常简单。

勾选后,点击 "Install Now",安装程序会自动完成安装,并处理好一些初始配置。

3 验证安装

安装完成后,打开 命令提示符PowerShell,你可以在开始菜单搜索 cmdpowershell 并打开。

在命令行窗口中,依次输入以下两个命令:

Python安装教程,步骤详细吗?-图3
(图片来源网络,侵删)
  1. 检查 Python 版本

    python --version

    或者

    python -V

    如果安装成功,它会显示你安装的 Python 版本,Python 3.12.0

  2. 进入 Python 交互式解释器

    python

    如果成功,你会看到类似下面的提示符:

    Python 3.12.0 (tags/v3.12.0:0fb18b0, Oct  2 2025, 15:54:34) [MSC v.1935 64 bit (AMD64)] on win32
    Type "help", "copyright", "credits" or "license" for more information.
    >>>

    >>> 后面输入 print("Hello, World!"),然后按回车,如果看到输出 Hello, World!,说明一切正常,输入 exit() 或按 Ctrl+Z 再按回车可以退出解释器。

4 python 命令无效怎么办?(配置环境变量)

如果你在验证步骤时,系统提示 'python' 不是内部或外部命令,也不是可运行的程序或批处理文件,说明你没有在安装时勾选 "Add python.exe to PATH"。

手动配置环境变量方法:

  1. 在 Windows 搜索栏中搜索 “编辑系统环境变量” 并打开它。
  2. 在弹出的 “系统属性” 窗口中,点击右下角的 “环境变量...” 按钮。
  3. 在下方的 “系统变量” 部分,找到并选中名为 Path 的变量,然后点击 “编辑...”。
  4. 在 “编辑环境变量” 窗口中,点击 “新建”,然后点击 “浏览”,找到你的 Python 安装目录(通常是 C:\Users\你的用户名\AppData\Local\Programs\Python\Python312)和 Scripts 目录(C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\Scripts)。
  5. 将这两个路径都添加进去,确保它们的顺序在 Path 列表的上方,你可以通过上下箭头调整顺序。
  6. 一路点击 “确定” 保存所有更改。
  7. 重要:关闭所有已打开的命令行窗口,然后重新打开一个新的,再尝试 python --version 命令。

第三步:在 macOS 上安装 Python

macOS 通常自带 Python 2,但我们希望安装 Python 3。

1 使用 Homebrew(推荐方式)

Homebrew 是 macOS 上最流行的包管理器,如果还没有安装,请先访问 brew.sh 按照指示安装。

  1. 打开 终端 (Terminal)。
  2. 使用 Homebrew 安装 Python 3:
    brew install python
  3. Homebrew 会自动将 Python 3 的可执行文件链接到一个通用的命令 python3,并为你配置好 pip3

2 从官网下载安装

如果你不想使用 Homebrew,也可以直接下载 .pkg 安装包。

  1. python.org/downloads 下载最新的 .pkg 文件。
  2. 双击安装包,按照屏幕提示一步步完成安装,安装程序会自动处理好路径配置,你无需手动操作。

3 验证安装

打开 终端 (Terminal),输入以下命令:

  1. 检查 Python 3 版本

    python3 --version

    注意,在 macOS 上,为了避免与系统自带的 Python 2 冲突,Python 3 的命令通常是 python3

  2. 进入 Python 交互式解释器

    python3

    后续验证步骤与 Windows 相同。


第四步:在 Linux 上安装 Python

大多数 Linux 发行版(如 Ubuntu, Debian, CentOS, Fedora)都自带了 Python 3,但版本可能不是最新的。

1 使用包管理器

对于 Ubuntu/Debian 及其衍生版 (如 Mint):

打开终端,使用 apt 命令:

# 更新软件包列表
sudo apt update
# 安装 Python 3 及其 pip 包管理器
sudo apt install python3 python3-pip

对于 CentOS/RHEL/Fedora:

打开终端,使用 dnfyum 命令:

# 对于 Fedora 和较新的 CentOS
sudo dnf install python3 python3-pip
# 对于旧版的 CentOS
sudo yum install python3 python3-pip

2 验证安装

打开终端,输入以下命令:

  1. 检查 Python 3 版本

    python3 --version
  2. 进入 Python 交互式解释器

    python3

第五步:选择和配置代码编辑器

记事本不适合写代码,我们需要一个专业的代码编辑器。

1 为什么需要代码编辑器?

  • 语法高亮:让代码更易读。
  • 代码补全:提高编码效率。
  • 错误提示:实时发现代码中的语法错误。
  • 调试工具:帮助你找到并修复逻辑错误。

2 推荐编辑器:Visual Studio Code (VS Code)

VS Code 是一款免费、开源、功能极其强大的代码编辑器,是目前最流行的选择。

  1. 下载 VS Code:访问 https://code.visualstudio.com/ 下载并安装。
  2. 安装 Python 扩展
    • 打开 VS Code。
    • 点击左侧活动栏的 扩展 图标(四个方块)。
    • 在搜索框中输入 Python
    • 找到由 Microsoft 发布的官方 Python 扩展,点击 安装

3 在 VS Code 中配置 Python

安装 Python 扩展后,VS Code 会自动检测你系统上的 Python 环境,你可以在 VS Code 的右下角看到当前使用的 Python 版本。

  • 切换解释器:如果你想切换到不同的 Python 环境(比如后面要学的虚拟环境),可以按 Ctrl+Shift+P (Windows/Linux) 或 Cmd+Shift+P (macOS) 打开命令面板,输入 Python: Select Interpreter,然后选择你想要的 Python 环境。

第六步:编写并运行你的第一个 Python 程序

现在万事俱备,让我们来写点代码!

1 创建你的第一个文件 hello.py

  1. 在你的电脑上创建一个新文件夹,比如命名为 python_projects
  2. 用 VS Code 打开这个文件夹 (File -> Open Folder...)。
  3. 在 VS Code 中,创建一个新文件 (File -> New File),命名为 hello.py
  4. hello.py 文件中输入以下代码:
    print("Hello, World! 欢迎来到 Python 的世界!")

    print() 是一个在屏幕上输出文本的函数。

2 运行程序

在 VS Code 中,你有两种方式运行这个文件:

  1. 使用 VS Code 的运行按钮

    • 打开 hello.py 文件后,点击右上角的 ▶ (播放) 按钮
    • VS Code 会在其内置的终端中运行该文件,并显示输出结果。
  2. 使用命令行终端

    • 在 VS Code 中,点击顶部菜单的 终端 -> 新终端,这会在 VS Code 底部打开一个命令行窗口。
    • 确保终端的当前路径是你的项目文件夹(应该会显示 python_projects)。
    • 输入以下命令并按回车:
      python hello.py

      (在 macOS/Linux 上,python 命令指向 Python 2,你可能需要使用 python3 hello.py

    • 你会在终端中看到输出:
      Hello, World! 欢迎来到 Python 的世界!

恭喜!你已经成功安装了 Python,并写出了你的第一个程序!


第七步:常见问题与解决方案

1 安装后提示 'python' 不是内部或外部命令... (Windows)

原因:环境变量 PATH 未配置。 解决:参考 4 节 手动配置环境变量。

2 pip 命令无效或找不到

原因pip 是 Python 的包管理器,它的可执行文件通常位于 Python 安装目录下的 Scripts 文件夹,如果这个文件夹没有被添加到 PATH 环境变量中,系统就找不到它。 解决

  1. Windows:确保你在安装 Python 时勾选了 "Add python.exe to PATH",如果没有,请按照 4 节 的方法,将 Scripts 目录也添加到 PATH 中。
  2. macOS/Linux:尝试使用 pip3 命令。pip3 也不行,说明 Python 的 Scripts 目录可能不在 PATH 中,对于 macOS Homebrew 用户,这通常不会发生,对于 Linux 用户,确保你在安装 python3-pip 包时没有出错。

3 如何升级 Python 或 pip

  • 升级 pip

    python -m pip install --upgrade pip

    (macOS/Linux 上可能用 python3 -m pip ...

  • 升级 Python

    • Windows/macOS:下载新版本的安装包,覆盖安装即可。(注意:这不会删除旧版本,但新安装的版本会优先被使用)
    • Linux:使用包管理器升级,sudo apt upgrade python3

第八步:最佳实践建议

1 使用虚拟环境

当你开始开发多个项目时,不同的项目可能需要不同版本的库,虚拟环境可以为每个项目创建一个独立的、隔离的 Python 环境,避免版本冲突。

  1. 创建虚拟环境: 在你的项目文件夹下打开终端,运行:

    # 对于 Windows
    python -m venv venv
    # 对于 macOS/Linux
    python3 -m venv venv

    这会创建一个名为 venv 的新文件夹,里面包含了独立的 Python 解释器和 pip

  2. 激活虚拟环境

    • Windows (CMD):
      venv\Scripts\activate
    • Windows (PowerShell):
      .\venv\Scripts\Activate.ps1
    • macOS/Linux:
      source venv/bin/activate

      激活后,你的终端提示符前面会出现 (venv),表示你正在虚拟环境中工作。

  3. 在虚拟环境中安装库

    pip install requests

    这个 requests 库只会安装到当前的 venv 环境中,不会影响全局的 Python 环境。

  4. 退出虚拟环境

    deactivate

2 善用包管理器 pip

pip 是你与 Python 生态互动的最重要的工具。

  • 安装库pip install <库名>
  • 卸载库pip uninstall <库名>
  • 列出已安装的库pip list
  • 查看库的详细信息pip show <库名>

希望这份超详细的教程能帮助你顺利完成 Python 的安装和配置!祝你编程愉快!

分享:
扫描分享到社交APP
上一篇
下一篇