Python入门:手把手教你安装Python开发环境
Python入门手把手教你安装Python开发环境一、开篇工欲善其事必先利其器在上一篇文章中我们聊了Python是什么、为什么要学它。从今天开始我们要动真格的了——在你的电脑上把Python环境搭起来。 好消息是Python的安装过程非常简单全程图形化界面几分钟就能搞定。⚠️ 坏消息是有几个容易踩的坑如果装错了版本或者配置错了路径后面会很头疼。这篇文章我就带你一步步走确保一次成功。不管你的电脑是Windows、Mac还是Linux本文都会覆盖到。你可以根据需要跳到自己系统的部分去读但建议前三节都看一下里面有些通用知识很重要。二、准备工作选哪个Python版本2.1 版本选择的黄金法则在正式开始安装之前你必须做一个决定安装哪个版本的Python截止2025年Python的主流稳定版本如下版本状态建议Python 3.9稳定安全更新中兼容性最好的选择老项目首选Python 3.10稳定活跃维护结构模式匹配等新特性推荐Python 3.11稳定活跃维护性能大幅提升比3.10快10-60%强烈推荐Python 3.12稳定最新最新特性性能进一步提升Python 3.13开发中不推荐用于学习 我的建议选择Python 3.11或3.12。原因有三性能比老版本显著提升同样的代码跑得更快几乎所有主流第三方库都已经兼容语法更加现代化有一些好用的新特性⚠️ 绝对不要安装Python 2.xPython 2在2020年1月1日已经停止维护没有任何安全更新。如果看到任何教程还在教Python 2直接关掉那个教程太老了。2.2 我需要同时装多个版本吗不需要。对于初学者来说装一个版本就够用。如果你以后参与不同项目需要不同版本的Python可以用pyenv或conda来管理多版本。这个在后面的专栏文章里会专门讲。三、从哪里下载Python3.1 唯一的官方下载地址✅https://python.org/downloads/这是Python官方下载页面也是唯一推荐的下载渠道。打开后你会看到一个大大的黄色按钮上面写着当前最新版本。但我们不要直接点它——先往下看根据你的操作系统选对应的安装包。⚠️ 不要在百度软件中心、腾讯软件管家等第三方平台下载Python那些平台上的版本可能被捆绑了广告软件或者版本很旧。3.2 下载页面详解打开python.org/downloads之后你会看到页面顶部一个黄色按钮推荐最新版本页面下方按操作系统分类的下载链接和说明左侧导航可以按版本号查看所有历史版本对于本文我们下载Python 3.11.x或3.12.xx代表小版本号比如3.11.7、3.12.1等选当时最新的即可。下面我们分系统讲解。四、Windows平台安装详解4.1 下载Windows安装包进入python.org/downloads点击黄色的下载按钮或者往下翻找到Python Releases for Windows部分。你会看到两种安装包安装包类型文件名示例说明Executable installerpython-3.12.1-amd64.exe图形化安装向导推荐新手使用Embeddable packagepython-3.12.1-embed-amd64.zip嵌入式精简包不推荐选择 Executable installer。注意区分32位和64位如果你的电脑内存大于4GB选amd6464位如果你的电脑非常老旧2010年以前选x8632位现在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!1234515importthis✅ 如果以上都正常恭喜你Windows上的Python环境已经安装成功输入exit()或按CtrlZ然后回车退出Python交互环境。4.4 常见安装问题问题1提示python不是内部或外部命令这是因为没有把Python添加到PATH中。解决方法找到Python的安装目录比如D:\Python312右键此电脑→属性→高级系统设置→环境变量在系统变量中找到Path双击编辑新增两条记录D:\Python312D:\Python312\Scripts全部确定后重新打开命令提示符再次运行python --version问题2安装时提示Error writing to file可能是权限不足。以管理员身份运行安装程序右键exe文件→以管理员身份运行。问题3之前装过Python 2现在python命令还是指向老版本python命令指向了Python 2python3可能指向Python 3。解决方法使用py -3命令来启动Python 3这是Python Launcher的功能或者调整PATH中Python 3的路径排在Python 2前面五、Mac平台安装详解5.1 检查是否已内置PythonMac系统自带Python但版本通常很旧可能是Python 2.7或者较老的Python 3。我们先检查一下打开Terminal终端应用程序在Launchpad→其他→终端或按Command空格搜索终端输入python3--version如果显示版本号低于3.10建议重新安装最新版。5.2 安装方式选择Mac上有多种安装Python的方式方式优点缺点官方安装包.pkg最简单一键安装卸载需要手动操作Homebrew包管理器方便管理、更新和卸载需要先装Homebrewpyenv版本管理器轻松切换多版本配置稍复杂对于新手我推荐两种方式官方安装包最简单或HomebrewMac开发者必装工具早晚都要装。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安装Pythonbrewinstallpython3.12Homebrew会自动下载、安装并配置好一切。包括pip也会一并装好。③ 验证安装python3--versionpip3--version✅ 用Homebrew安装的好处是以后更新Python只需执行brew upgrade python3.12卸载只需brew uninstall python3.12非常干净。5.5 安装pip的确认使用官方pkg安装的Pythonpip会自动安装。用以下命令验证pip3--version如果提示pip3: command not found执行python3-mensurepip--upgrade六、Linux平台安装详解6.1 检查系统自带的PythonLinux发行版通常预装了Python 3。先检查一下python3--version如果版本在3.10以上可以直接使用。如果不是或者你想安装最新版本继续往下看。6.2 Ubuntu/Debian系统① 更新软件包列表sudoaptupdate② 安装Pythonsudoaptinstallpython3 python3-pip python3-venv这会安装Python 3以及pip和venv工具。③ 如果你需要更新版本的Python可以添加deadsnakes PPAsudoaptupdatesudoaptinstallsoftware-properties-commonsudoadd-apt-repository ppa:deadsnakes/ppasudoaptupdatesudoaptinstallpython3.12 python3.12-venv python3.12-distutils6.3 CentOS/RHEL/Fedora系统# Fedorasudodnfinstallpython3 python3-pip# CentOS/RHEL 8sudodnfinstallpython3 python3-pip# CentOS/RHEL 7sudoyuminstallpython3 python3-pip6.4 Arch Linuxsudopacman-Spython python-pip6.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 requests7.3 配置国内镜像源强烈推荐⚠️ 重要的一步pip默认从国外的PyPI服务器下载包速度可能很慢几KB/s甚至超时。配置国内镜像源之后下载速度可以达到几MB/s。以下是主流的国内镜像源镜像源URL清华大学https://pypi.tuna.tsinghua.edu.cn/simple阿里云https://mirrors.aliyun.com/pypi/simple中国科学技术大学https://pypi.mirrors.ustc.edu.cn/simple豆瓣https://pypi.douban.com/simple 配置方法永久生效① 在你的用户目录下创建一个pip配置文件夹Windowsmkdir%USERPROFILE%\pip在C:\Users\你的用户名\pip\目录下创建文件pip.ini内容如下[global] index-url https://pypi.tuna.tsinghua.edu.cn/simple [install] trusted-host pypi.tuna.tsinghua.edu.cnMac/Linuxmkdir-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. 获取用户输入nameinput(请输入你的名字)print(f\n你好{name}很高兴认识你)# 3. 做一个简单计算num1int(input(\n请输入第一个数字))num2int(input(请输入第二个数字))print(f\n{num1}{num2}{num1num2})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. 条件和循环numint(input(f\n{name}请输入一个整数我帮你判断奇偶))ifnum%20: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你会看到程序开始交互运行它会打印欢迎信息询问你的名字让你输入两个数字帮你做加减乘除展示字符串操作判断奇偶、打印乘法表✅ 如果你看到了这一切你的Python环境已经可以正常工作了。8.3 常见的运行错误IndentationError缩进错误Python靠缩进来组织代码块。确保同一层级的代码缩进一致推荐用4个空格。SyntaxError语法错误检查是否少写了冒号:、括号()或者引号不匹配。NameError名称错误用了没定义的变量。检查变量名是否拼写正确。 遇到错误不要慌。把错误信息最后一行通常以Error结尾的那行复制到搜索引擎搜索99%的问题都能找到解决方案。学会面向搜索引擎编程是程序员的基本功。九、交互式编程 vs 脚本编程Python有两种写代码的方式各有各的用途9.1 交互式环境REPL在命令行输入python进入的就是交互式环境REPLRead-Eval-Print Loop。在这个环境里你每输入一行代码Python就立刻执行并显示结果。358hello.upper()HELLO[1,2,3][4,5,6][1,2,3,4,5,6] 交互式环境适合测试一小段代码快速验证想法作为计算器使用探索新库的API9.2 脚本文件.py文件就是把代码写在文件里一次性执行。适合需要保存和复用的代码比较长的逻辑分享给别人你日常开发99%的时间都是在写脚本文件。十、本篇小结✅ 今天你完成了学习Python最重要的一步把开发环境搭起来了。总结一下关键点选对版本Python 3.11或3.12不要用Python 2官方下载python.org别在第三方平台下安装时勾上Add Python to PATH这是Windows用户最常见的坑配置pip国内镜像源大幅提升下载第三方库的速度学会了两种运行方式交互式环境python和脚本文件python hello.py 环境搭好之后后续的学习就是一路坦途了。下一篇文章我们会详细讲解Windows平台的Python环境配置细节包括IDLE的使用、环境变量的深入理解、以及一些实用的配置技巧。