在不同操作系统上安装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 + 5
15
>>> import this

✅ 如果以上都正常，恭喜你，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 -fssl https://raw.githubusercontent.com/homebrew/install/head/install.sh)"

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

② 用homebrew安装python：

brew install python@3.12

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

③ 验证安装：

python3 --version
pip3 --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 -m ensurepip --upgrade

六、linux平台安装详解

6.1 检查系统自带的python

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

python3 --version

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

6.2 ubuntu/debian系统

① 更新软件包列表：

sudo apt update

② 安装python：

sudo apt install python3 python3-pip python3-venv

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

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

sudo apt update
sudo apt install software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.12 python3.12-venv python3.12-distutils

6.3 centos/rhel/fedora系统

# fedora
sudo dnf install python3 python3-pip

# centos/rhel 8+
sudo dnf install python3 python3-pip

# centos/rhel 7
sudo yum install python3 python3-pip

6.4 arch linux

sudo pacman -s python python-pip

6.5 验证安装

python3 --version
pip3 --version

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

七、pip的初识与配置

7.1 pip是什么

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

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

7.2 pip的基本使用

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

# 查看pip版本
pip --version

# 安装一个库（以requests为例，它是一个http请求库）
pip install requests

# 查看已安装的库
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

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

pip install requests

你会看到下载速度明显快了很多，一般能达到几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}，请输入一个整数，我帮你判断奇偶：'))
if num % 2 == 0:
    print(f'{num} 是偶数')
else:
    print(f'{num} 是奇数')
print(f'\n{name}，下面是1到10的乘法表：')
for i in range(1, 10):
    print(f'{num} × {i} = {num * i}')
print('\n' + '=' * 50)
print(f'程序结束，{name}下次见！')
print('=' * 50)

8.2 运行python脚本

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

# windows
cd c:\users\你的用户名\desktop\python_learning
python hello.py

# mac/linux
cd ~/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 + 5
8
>>> '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的使用、环境变量的深入理解、以及一些实用的配置技巧。

以上就是在不同操作系统上安装python开发环境的方法步骤的详细内容，更多关于python开发环境安装步骤的资料请关注代码网其它相关文章！