Python入门：手把手教你安装Python开发环境

Python入门：手把手教你安装Python开发环境

一、开篇：工欲善其事，必先利其器

在上一篇文章中，我们聊了Python是什么、为什么要学它。从今天开始，我们要动真格的了——在你的电脑上把Python环境搭起来。

💡 好消息是：Python的安装过程非常简单，全程图形化界面，几分钟就能搞定。

⚠️ 坏消息是：有几个容易踩的坑，如果装错了版本或者配置错了路径，后面会很头疼。这篇文章我就带你一步步走，确保一次成功。

不管你的电脑是Windows、Mac还是Linux，本文都会覆盖到。你可以根据需要跳到自己系统的部分去读，但建议前三节都看一下，里面有些通用知识很重要。

二、准备工作：选哪个Python版本

2.1 版本选择的黄金法则

在正式开始安装之前，你必须做一个决定：安装哪个版本的Python？

截止2025年，Python的主流稳定版本如下：

💡 我的建议：选择Python 3.11或3.12。原因有三：

1. 性能比老版本显著提升，同样的代码跑得更快
2. 几乎所有主流第三方库都已经兼容
3. 语法更加现代化，有一些好用的新特性

⚠️ 绝对不要安装Python 2.x！Python 2在2020年1月1日已经停止维护，没有任何安全更新。如果看到任何教程还在教Python 2，直接关掉，那个教程太老了。

2.2 我需要同时装多个版本吗

不需要。对于初学者来说，装一个版本就够用。如果你以后参与不同项目，需要不同版本的Python，可以用pyenv或conda来管理多版本。这个在后面的专栏文章里会专门讲。

三、从哪里下载Python

3.1 唯一的官方下载地址

✅https://python.org/downloads/

这是Python官方下载页面，也是唯一推荐的下载渠道。打开后你会看到一个大大的黄色按钮，上面写着当前最新版本。但我们不要直接点它——先往下看，根据你的操作系统选对应的安装包。

⚠️ 不要在百度软件中心、腾讯软件管家等第三方平台下载Python！那些平台上的版本可能被捆绑了广告软件，或者版本很旧。

3.2 下载页面详解

打开python.org/downloads之后，你会看到：

• 页面顶部：一个黄色按钮，推荐最新版本
• 页面下方：按操作系统分类的下载链接和说明
• 左侧导航：可以按版本号查看所有历史版本

对于本文，我们下载Python 3.11.x或3.12.x（x代表小版本号，比如3.11.7、3.12.1等，选当时最新的即可）。

下面我们分系统讲解。

四、Windows平台安装详解

4.1 下载Windows安装包

进入python.org/downloads，点击黄色的下载按钮，或者往下翻找到"Python Releases for Windows"部分。你会看到两种安装包：

选择 Executable installer。注意区分32位和64位：

• 如果你的电脑内存大于4GB，选amd64（64位）
• 如果你的电脑非常老旧（2010年以前），选x86（32位）

现在99%的电脑都是64位，直接选amd64版本即可。

4.2 安装步骤详解

① 下载完成后，双击exe文件，弹出安装向导。

⚠️ 关键步骤！在安装向导的第一个界面底部，有一个复选框：

☑ Install launcher for all users (recommended) ☐ Add Python 3.12 to PATH

第二个复选框"Add Python 3.12 to PATH"一定要勾上！

这个选项会把Python的安装目录添加到系统的PATH环境变量中。勾上它，你就可以在命令行（CMD或PowerShell）的任何路径下直接输入python来启动Python。

如果忘记勾选，后面也可以手动添加，但多一事不如少一事，第一次就勾上。

② 接下来有两个安装选项：

• Install Now：默认安装，装到C盘用户目录下。适合新手，什么都不用管。
• Customize installation：自定义安装，可以选择安装路径和组件。

我推荐选Customize installation，因为你可以把Python装到D盘（免得到时候C盘空间不够），并且能确认所有有用的组件都被勾选。

③ 如果选了自定义安装，你会进入 “Optional Features” 页面：

☑ Documentation # Python官方文档 ☑ pip # 包管理工具（必须勾！） ☑ tcl/tk and IDLE # 自带编辑器和GUI库 ☑ Python test suite # 测试套件 ☑ py launcher # 多版本启动器 ☑ for all users # 为所有用户安装

全部勾选，特别是pip一定要勾上。pip是Python的包管理工具，后面我们安装第三方库全靠它。

④ 点击Next，进入 “Advanced Options” 页面：

• Install for all users：勾上
• Associate files with Python：勾上（让.py文件默认用Python打开）
• Create shortcuts for installed applications：勾上
• Add Python to environment variables：勾上
• Precompile standard library：勾上（提前编译标准库，加速首次运行）
• Download debugging symbols：可以不勾（初学者用不上）
• Download debug binaries：可以不勾

在"Customize install location"中，你可以把安装路径改为D盘：

D:\Python312

⑤ 点击Install，等待安装完成。安装结束后，点击"Disable path length limit"（解除Windows的260字符路径长度限制），然后关闭安装向导。

4.3 验证安装是否成功

① 按Win + R，输入cmd，回车打开命令提示符。

② 输入以下命令：

python--version

如果看到类似输出，说明安装成功：

Python 3.12.1

③ 再输入以下命令进入Python交互环境：

python

你会看到类似这样的提示：

Python 3.12.1 (tags/v3.12.1:2305ca5, Dec 7 2023, 22:03:25) [MSC v.1937 64 bit (AMD64)] on win32 Type "help", "copyright", "credits" or "license" for more information. >>>

④ 在>>>提示符后面输入你的第一行Python代码：

>>>print('Hello, Python!')Hello,Python!>>>1+2+3+4+515>>>importthis

✅ 如果以上都正常，恭喜你，Windows上的Python环境已经安装成功！

输入exit()或按Ctrl+Z然后回车，退出Python交互环境。

4.4 常见安装问题

问题1：提示"python不是内部或外部命令"

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

1. 找到Python的安装目录（比如D:\Python312）
2. 右键"此电脑"→"属性"→"高级系统设置"→"环境变量"
3. 在"系统变量"中找到Path，双击编辑
4. 新增两条记录：
   • D:\Python312
   • D:\Python312\Scripts
5. 全部确定后，重新打开命令提示符，再次运行python --version

问题2：安装时提示"Error writing to file"

可能是权限不足。以管理员身份运行安装程序：右键exe文件→"以管理员身份运行"。

问题3：之前装过Python 2，现在python命令还是指向老版本

python命令指向了Python 2，python3可能指向Python 3。解决方法：

• 使用py -3命令来启动Python 3（这是Python Launcher的功能）
• 或者调整PATH中Python 3的路径排在Python 2前面

五、Mac平台安装详解

5.1 检查是否已内置Python

Mac系统自带Python，但版本通常很旧（可能是Python 2.7或者较老的Python 3）。我们先检查一下：

打开Terminal（终端）应用程序（在Launchpad→其他→终端，或按Command+空格搜索"终端"），输入：

python3--version

如果显示版本号低于3.10，建议重新安装最新版。

5.2 安装方式选择

Mac上有多种安装Python的方式：

对于新手，我推荐两种方式：官方安装包（最简单）或Homebrew（Mac开发者必装工具，早晚都要装）。

5.3 方式A：官方安装包

① 访问 python.org/downloads，网站会自动识别你是Mac系统，推荐对应的安装包。下载.pkg文件。

② 双击下载好的pkg文件，按照向导点击"继续"→"继续"→"同意"→"安装"。

③ 安装完成后，系统可能会弹出窗口问你要不要删除安装包，选择"移到废纸篓"即可。

④ 打开Terminal，验证安装：

python3--version

你会看到刚安装的版本号。

⚠️ Mac上命令是python3而不是python。因为Mac系统自带的python命令指向Python 2（较老的系统）或禁止使用。养成用python3的习惯。

5.4 方式B：使用Homebrew安装

① 先安装Homebrew。打开Terminal，粘贴以下命令：

/bin/bash-c"$(curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

按照提示完成Homebrew安装（中间会要求输入你的Mac登录密码）。

② 用Homebrew安装Python：

brewinstallpython@3.12

Homebrew会自动下载、安装并配置好一切。包括pip也会一并装好。

③ 验证安装：

python3--versionpip3--version

✅ 用Homebrew安装的好处是：以后更新Python只需执行brew upgrade python@3.12，卸载只需brew uninstall python@3.12，非常干净。

5.5 安装pip的确认

使用官方pkg安装的Python，pip会自动安装。用以下命令验证：

pip3--version

如果提示pip3: command not found，执行：

python3-mensurepip--upgrade

六、Linux平台安装详解

6.1 检查系统自带的Python

Linux发行版通常预装了Python 3。先检查一下：

python3--version

如果版本在3.10以上，可以直接使用。如果不是，或者你想安装最新版本，继续往下看。

6.2 Ubuntu/Debian系统

① 更新软件包列表：

sudoaptupdate

② 安装Python：

sudoaptinstallpython3 python3-pip python3-venv

这会安装Python 3以及pip和venv工具。

③ 如果你需要更新版本的Python，可以添加deadsnakes PPA：

sudoaptupdatesudoaptinstallsoftware-properties-commonsudoadd-apt-repository ppa:deadsnakes/ppasudoaptupdatesudoaptinstallpython3.12 python3.12-venv python3.12-distutils

6.3 CentOS/RHEL/Fedora系统

# Fedorasudodnfinstallpython3 python3-pip# CentOS/RHEL 8+sudodnfinstallpython3 python3-pip# CentOS/RHEL 7sudoyuminstallpython3 python3-pip

6.4 Arch Linux

sudopacman-Spython python-pip

6.5 验证安装

python3--versionpip3--version

✅ 显示出版本号就说明安装成功了。

七、pip的初识与配置

7.1 pip是什么

⌨️ pip是Python Package Installer的缩写，是Python官方推荐的包管理工具。它的作用是帮你下载、安装、卸载、管理第三方Python库。

简单理解：Python自带的"标准库"功能有限，要做爬虫、数据分析、Web开发这些事情，你需要安装第三方库。而pip就是你安装这些库的工具。

7.2 pip的基本使用

打开命令行（终端），试试以下命令：

# 查看pip版本pip--version# 安装一个库（以requests为例，它是一个HTTP请求库）pipinstallrequests# 查看已安装的库pip list# 卸载一个库pip uninstall requests# 查看某个库的详细信息pip show requests

7.3 配置国内镜像源（强烈推荐）

⚠️ 重要的一步！pip默认从国外的PyPI服务器下载包，速度可能很慢（几KB/s甚至超时）。配置国内镜像源之后，下载速度可以达到几MB/s。

以下是主流的国内镜像源：

💡 配置方法（永久生效）：

① 在你的用户目录下创建一个pip配置文件夹：

Windows：

mkdir%USERPROFILE%\pip

在C:\Users\你的用户名\pip\目录下创建文件pip.ini，内容如下：

[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple [install] trusted-host = pypi.tuna.tsinghua.edu.cn

Mac/Linux：

mkdir-p~/.pip

编辑~/.pip/pip.conf文件：

[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple [install] trusted-host = pypi.tuna.tsinghua.edu.cn

② 配置完成后，测试一下速度：

pipinstallrequests

你会看到下载速度明显快了很多，一般能达到几MB/s。

八、第一个Python程序的正确运行方式

环境装好了，我们来正式运行第一个程序。不仅仅是在交互环境里敲一行代码，而是创建一个真正的Python脚本文件。

8.1 创建Python脚本

① 在桌面上新建一个文件夹，命名为python_learning（你以后所有的练习代码都可以放在这里）。

② 打开这个文件夹，新建一个文本文件，重命名为hello.py。

⚠️ Windows用户注意：确保文件扩展名是.py而不是.py.txt。在文件资源管理器中，点击"查看"→勾选"文件扩展名"，这样你就能看到并修改文件的扩展名了。

③ 右键hello.py，选择用记事本（Windows）或文本编辑（Mac）打开，输入以下内容：

# -*- coding: utf-8 -*-""" 我的第一个Python程序 这个程序会打招呼、做计算、展示Python的基本能力 """# 1. 打印问候语print('='*50)print('欢迎来到Python编程的世界！')print('='*50)# 2. 获取用户输入name=input('请输入你的名字：')print(f'\n你好，{name}！很高兴认识你！')# 3. 做一个简单计算num1=int(input('\n请输入第一个数字：'))num2=int(input('请输入第二个数字：'))print(f'\n{num1}+{num2}={num1+num2}')print(f'{num1}-{num2}={num1-num2}')print(f'{num1}×{num2}={num1*num2}')print(f'{num1}÷{num2}={num1/num2:.2f}')# 4. 展示字符串操作print(f'\n{name}，你的名字有{len(name)}个字符')print(f'你的名字倒过来是：{name[::-1]}')# 5. 条件和循环num=int(input(f'\n{name}，请输入一个整数，我帮你判断奇偶：'))ifnum%2==0:print(f'{num}是偶数')else:print(f'{num}是奇数')print(f'\n{name}，下面是1到10的乘法表：')foriinrange(1,10):print(f'{num}×{i}={num*i}')print('\n'+'='*50)print(f'程序结束，{name}下次见！')print('='*50)

8.2 运行Python脚本

打开命令行，cd到你的python_learning文件夹：

# WindowscdC:\Users\你的用户名\Desktop\python_learning python hello.py# Mac/Linuxcd~/Desktop/python_learning python3 hello.py

你会看到程序开始交互运行，它会：

1. 打印欢迎信息
2. 询问你的名字
3. 让你输入两个数字，帮你做加减乘除
4. 展示字符串操作
5. 判断奇偶、打印乘法表

✅ 如果你看到了这一切，你的Python环境已经可以正常工作了。

8.3 常见的运行错误

IndentationError（缩进错误）：Python靠缩进来组织代码块。确保同一层级的代码缩进一致（推荐用4个空格）。

SyntaxError（语法错误）：检查是否少写了冒号:、括号()或者引号不匹配。

NameError（名称错误）：用了没定义的变量。检查变量名是否拼写正确。

💡 遇到错误不要慌。把错误信息最后一行（通常以Error结尾的那行）复制到搜索引擎搜索，99%的问题都能找到解决方案。学会"面向搜索引擎编程"是程序员的基本功。

九、交互式编程 vs 脚本编程

Python有两种写代码的方式，各有各的用途：

9.1 交互式环境（REPL）

在命令行输入python进入的就是交互式环境（REPL：Read-Eval-Print Loop）。在这个环境里，你每输入一行代码，Python就立刻执行并显示结果。

>>>3+58>>>'hello'.upper()'HELLO'>>>[1,2,3]+[4,5,6][1,2,3,4,5,6]

💡 交互式环境适合：

• 测试一小段代码
• 快速验证想法
• 作为计算器使用
• 探索新库的API

9.2 脚本文件（.py文件）

就是把代码写在文件里，一次性执行。适合：

• 需要保存和复用的代码
• 比较长的逻辑
• 分享给别人

你日常开发99%的时间都是在写脚本文件。

十、本篇小结

✅ 今天你完成了学习Python最重要的一步：把开发环境搭起来了。总结一下关键点：

1. 选对版本：Python 3.11或3.12，不要用Python 2
2. 官方下载：python.org，别在第三方平台下
3. 安装时勾上"Add Python to PATH"：这是Windows用户最常见的坑
4. 配置pip国内镜像源：大幅提升下载第三方库的速度
5. 学会了两种运行方式：交互式环境（python）和脚本文件（python hello.py）

💡 环境搭好之后，后续的学习就是一路坦途了。下一篇文章，我们会详细讲解Windows平台的Python环境配置细节，包括IDLE的使用、环境变量的深入理解、以及一些实用的配置技巧。