简介面向初学者的 Python 环境搭建指南围绕 Python 解释器安装与 PyCharm 集成开发环境配置展开内容按“下载—安装—验证—建项目—写代码”的顺序推进适合刚接触编程、准备系统学习 Python 的用户。资源以一份 docx 文档呈现全文共 1 个文件压缩包大小 1.14MB步骤配有界面截图式的说明可边看边操作。文档重点说明 Python 官方版本下载、安装时必勾选项与自定义路径以及 PyCharm 的下载安装、解释器选择和新建项目流程同时补充变量、数据类型、运算符、控制结构等基础语法和应用领域方便读者完成后直接进入练习。目前已有 1120 人学习下载对于想快速搭好开发环境并运行第一个程序的新手是一份轻量实用的入门参考。1. 把 Python 装上只是开始为什么安装步骤值得认真对待Python 的安装向来被当作“下一步下一步就完事”的操作但实际开发中大量翻车现场——命令找不到、版本对不上、pip 装啥都超时、IDE 里跑的和终端里跑的不是同一个解释器——几乎都能追溯到安装这一步埋下的隐患。这篇笔记就是把“Python 详细安装步骤”这件事从选版本、选通道、配环境变量到验证安装、处理多版本共存完整拆开讲清楚。你可能是刚转 Python 的初学者也可能是被环境折腾过几次的从业者照着这套路径走能少走很多弯路。我见过太多人卡在第一步下载了安装包却不知道 64 位和 32 位怎么选装完不知道“Add to PATH”是干什么的更别提后面虚拟环境、镜像源这些事了。本文不会只贴一段安装命令就收工而是把每个选项背后的逻辑、装完必须做的几项验证、以及高频踩坑点和排查方法都写出来。方向对了后面写代码才顺。2. 安装前必须想清楚的三件事版本、位数与下载来源2.1 版本选择别追新也别守着老版本不放Python 的版本策略是“一个主版本线长期维护新功能在小版本里迭代”。对绝大多数从业者来说选版本的核心依据不是“最新”而是“生态兼容性”。第三方库对新语法特性的跟进有滞后如果一上来就装最新大版本很可能遇到某个核心依赖还没适配的情况。常见的做法是选择当前处于“维护期”的稳定版本线这类版本会持续收到安全修复和 bug 修复同时又已经经过了大半年的生态验证。从实际项目角度看还要区分你打算拿 Python 做什么。做数据分析和机器学习通常跟随主流框架的兼容性要求走做 Web 后端或自动化脚本则可以稍微保守一点。我的建议是看你要用的核心库官方声明支持哪些版本再在这个范围内选最新的小版本号。比如某个版本线已经出到 3.12.x而 3.11 系列依然在维护期内那就选 3.11 的最新小版本兼顾稳定性和新特性。2.2 32 位还是 64 位这决定你能不能用上大内存现在的电脑内存普遍 8G 起步16G 甚至 32G 都很常见。如果安装了 32 位的 Python单个进程最多只能用约 4G 内存做数据处理时内存稍微涨上去就直接崩。而 64 位版本没有这个限制能完整利用物理内存。所以只要你的操作系统是 64 位的——现在几乎都是——就选 64 位安装包。有个例外情况如果你需要和某些老旧的 32 位动态链接库交互或者你的项目必须部署到 32 位的老机器上那才需要考虑 32 位版本。但这种场景在日常开发中已经非常少见了。判断系统位数的方法很简单# Windows 下在 cmd 或 PowerShell 中执行 echo %PROCESSOR_ARCHITECTURE% # macOS 下执行ARM64 表示 Apple SiliconX86_64 表示 Intel uname -m # Linux 下执行 uname -m这段命令的输出直接告诉你当前系统架构。在 Windows 上看到 AMD64 或 x86_64 就说明是 64 位系统对应的下载-amd64.exe安装包macOS 的 Apple Silicon 芯片要下arm64版本Intel 芯片则选x86_64版本。我见过有人在 Apple Silicon 的 Mac 上装了 x86 版 Python虽然能用但总是走一层转译性能和兼容性都不理想。2.3 下载来源官方渠道是第一选择镜像站是备选Python 官方安装包托管在官方网站下载慢是常态尤其在国内网络环境下几十 MB 的安装包可能要等很久。常见的做法是优先使用官方渠道如果速度实在不可接受再去可靠的镜像站下载。需要特别注意的是下载完成后核对一下文件校验值官方页面会给出每个安装包的 SHA256 哈希。这一步看似繁琐却是防止下载到被篡改文件的有效手段。校验文件完整性的命令在各平台上有差异# Windows PowerShell 中计算 SHA256 Get-FileHash .\python-3.12.3-amd64.exe -Algorithm SHA256 # macOS / Linux 中计算 SHA256 shasum -a 256 python-3.12.3-amd64.exe把输出结果和官网页面上的哈希值逐位对比一致才说明文件完整。我在早期安装时从没做过这步直到有一次从非官方渠道下载的安装包在安装时弹出了异常提示才意识到校验的重要性。从那以后每次下载完必做这一步也建议所有看这篇笔记的人保持这个习惯尤其是当你要在团队内部或生产环境统一安装 Python 时。3. 分平台安装实操Windows、macOS 与 Linux 的完整步骤3.1 Windows 安装重点在“Add to PATH”和“py 启动器”Windows 平台的安装包是图形化向导看起来简单但有几个选项直接决定后面会不会翻车。双击运行下载好的.exe文件后第一屏最下方有一个“Add Python to PATH”的复选框这个默认是不勾选的。如果跳过它直接点 Install Now装完后在终端里输入python大概率得到“不是内部或外部命令”的提示。这也是 Windows 上最常见的 Python 安装问题十个人里至少有五个人在这栽过。我一般推荐勾选“Add Python to PATH”然后选择 Customize installation 而非 Install Now目的是自定义安装路径和确认可选组件。进入 Optional Features 页面时把 pip、py launcher 都勾上Advanced Options 里有一个“Install for all users”的选项如果你的电脑是单人使用勾不勾都行但如果你需要用管理员权限操作或准备安装全局工具包建议勾上。安装完成后打开一个新的终端窗口验证命令# 验证 Python 是否可用 python --version # 验证包管理器是否可用 pip --version # 验证 py 启动器是否可用 py --version三个命令都有正常输出就说明基础安装成功了。这里有个容易被忽略的细节安装完 Python 后必须关掉旧终端再开新的否则 PATH 环境变量的更新不会生效输入python依然会提示找不到命令。很多人在这一步反复重装 Python其实只需要重启一下终端窗口就能解决。如果安装时忘了勾选 Add to PATH也不用重装可以手动把 Python 的安装目录和它的 Scripts 子目录加到系统环境变量里。打开“系统属性 → 环境变量”在系统变量里找到 Path编辑并新增两条路径比如C:\Python312和C:\Python312\Scripts保存后重开终端。添加 Scripts 目录是为了让系统能找到 pip 等命令行工具只添加 Python 根目录的话pip 依然会提示找不到命令。3.2 macOS 安装官方安装包与 Homebrew 的取舍macOS 上安装 Python 有两条主流路线一是从官网下载 macOS 安装包二是用 Homebrew 安装。两条路线各有适合的场景。从官网下载的安装包会把 Python 装到/Library/Frameworks/Python.framework下并且自带的安装器会帮你把python3命令链接到/usr/local/bin整个过程对新手更友好图形界面确认几次就完成。而 Homebrew 的安装方式对已经有包管理习惯的开发者更自然升级、卸载都通过brew命令统一管理。需要注意macOS 系统自带的/usr/bin/python3是系统组件不要动它也不要尝试卸载。系统自带的版本通常比较旧而且装了很多系统脚本依赖它。我们安装的 Python 会独立存在通过 PATH 的优先级让你在终端里输入python3时优先命中的是新装的版本。查看当前实际使用的是哪个 Python# 查看 python3 实际指向的路径 which python3 # 查看版本信息 python3 --version如果which python3输出的路径是/usr/local/bin/python3或/opt/homebrew/bin/python3说明用的是新装的版本如果输出的是/usr/bin/python3说明还在用系统自带版。后者的解决方法是检查安装后是否重开了终端或者手动调整 PATH 顺序让/usr/local/bin排在/usr/bin前面。用 Homebrew 安装的好处是后续装 Python 相关的工具链时会省心很多因为 brew 会自动处理依赖关系。安装命令极简# 搜索可用的 Python 版本 brew search python # 安装最新稳定版 brew install pythonHomebrew 默认安装的是当前最新的 Python 3 稳定版。装完以后python3和pip3两个命令直接可用。注意 Homebrew 安装的 Python 中pip 对应的命令是pip3这个细节在写脚本或配置 CI 时特别容易踩坑因为很多自动化脚本里写的是pip在 macOS 上可能提示找不到命令。3.3 Linux 安装包管理器快速装与源码编译的边界Linux 发行版众多Debian/Ubuntu 系用 aptCentOS/RHEL 系用 yum 或 dnfArch 系用 pacman。使用系统包管理器安装 Python 是最省事的做法依赖自动处理升级也方便。但缺点同样明显系统仓库里的 Python 版本往往比官方最新版落后不少某些需要较新语法特性或新版本标准库功能的项目会因此受限。在 Ubuntu/Debian 上常见的做法是安装python3和python3-pip两个包# 更新包索引 sudo apt update # 安装 Python 3 和 pip sudo apt install -y python3 python3-pip # 验证安装结果 python3 --version pip3 --versionDebian 系发行版默认不把python命令链接到python3这是刻意为之因为系统里有太多脚本依赖 Python 2 的语法。所以新用户常遇到的现象是输入python提示找不到命令输入python3却能正常使用。这不是安装失败只是发行版的默认策略。如果你确认系统里没有遗留的 Python 2 依赖可以做软链接把python指向python3但我不建议在生产环境这么做风险大于便利。如果需要安装特定版本的 Python 或比系统仓库更新的版本常见的做法是用 pyenv 这类版本管理工具或者直接下载源码编译。源码编译的过程相对繁琐需要先安装编译依赖# Ubuntu/Debian 上安装编译所需的依赖库 sudo apt install -y build-essential libssl-dev zlib1g-dev \ libbz2-dev libreadline-dev libsqlite3-dev libffi-dev \ liblzma-dev依赖装好后从官方下载源码包解压后执行标准的三步流程./configure配置编译选项make编译make install安装。全程耗时取决于机器性能通常 5 到 15 分钟。源码编译方式的优势是配置灵活可以指定安装前缀、开启或关闭特定模块劣势是升级和卸载都要自己管理不像包管理器那样一条命令搞定。我的习惯是开发机上用 pyenv 管理多版本生产服务器上优先用系统包管理器实在需要特定版本才走源码编译。4. 装完不等于装好环境验证与基础配置4.1 验证解释器、pip 与 PATH 指向安装完成后的第一件事不是写 Hello World而是确认安装结果。很多人安装时报错或者 PATH 配错等到写代码时才发现问题那时候排查起来效率很低。我习惯在终端依次跑一组命令把基础环境情况摸清楚# 验证解释器版本 python --version # 或 macOS/Linux 上使用 python3 --version # 验证 pip 版本 pip --version # 或 pip3 --version # 查看解释器实际路径确认 PATH 生效 which python which pippython --version输出的版本号应该和你安装的版本一致。pip --version除了版本号还会显示它关联的 Python 的路径值得看一眼——如果 pip 关联到的 Python 路径不是你自己安装的那个说明系统里存在多个 Python 环境pip 被 PATH 里排在前面的那个环境接管了后续安装第三方库时会装到“错误”的 Python 里。which python直接显示了当前终端实际执行的 python 是哪个文件。这三个命令输出互相印证基本能确认 PATH 配置是否正确。如果在 Windows 上python --version有输出但pip --version报错最可能的原因是安装时取消了 pip 组件或者 Scripts 目录没在 PATH 里。解决办法是重新运行安装程序选择 Modify勾选 pip 组件。在 macOS 和 Linux 上pip 对应的命令通常是pip3如果pip提示找不到先试试pip3大概率能正常工作。4.2 配置 pip 镜像源把下载速度从“玄学”拉回正常pip 默认从官方源下载第三方库在国内网络环境下经常出现超时或速度极慢的情况。这不是 pip 的问题纯粹是网络链路的原因。常见做法是把 pip 源切换到国内镜像站速度会有质的提升。配置方法是在用户目录下创建或修改 pip 配置文件Linux 和 macOS 的路径是~/.pip/pip.conf或~/.config/pip/pip.confWindows 的路径是%APPDATA%\pip\pip.ini。配置文件的内容写法如下[global] index-url https://pypi.tuna.tsinghua.edu.cn/simple trusted-host pypi.tuna.tsinghua.edu.cn timeout 60第一行index-url指定了 pip 拉取包时访问的镜像地址。第二行trusted-host表示信任这个主机的 SSL 证书如果镜像站没有配置 HTTPS 证书或者你所在网络环境对 HTTPS 证书校验有特殊限制需要加这一行否则 pip 会拒绝连接。第三行timeout设置请求超时时间为 60 秒防止某个慢包长时间卡住整个安装流程。配置完成后测试一下效果# 用一个体积较大的包来测试下载速度 pip install pandas如果之前下载慢得让人抓狂切换镜像源后正常应该是几十秒到几分钟内完成。注意每次新增依赖时优先考虑先把依赖名称和版本写进requirements.txt然后统一安装这样比一条条pip install更可控后面章节会专门展开这个工作流。4.3 创建虚拟环境让每个项目有独立的依赖空间虚拟环境是 Python 生态里最重要的环境隔离手段它把某个项目的依赖装在一个独立的目录里不污染全局环境。在正式项目开始时第一步就是创建虚拟环境这是一个值得固化进肌肉记忆的操作。Python 3.3 以后自带venv模块不需要额外安装工具# 创建名为 venv 的虚拟环境目录 python -m venv venv # 激活虚拟环境 # Windows 下 venv\Scripts\activate # macOS / Linux 下 source venv/bin/activate创建完成后当前目录下会多出一个venv文件夹里面有独立的 Python 解释器和 pip。激活虚拟环境后终端命令行提示符会显示(venv)前缀这时候的python和pip都指向虚拟环境内的版本和全局环境完全隔离。看到这个前缀是激活成功的最直观标志如果没出现说明激活命令没生效或者终端会话有缓存导致 PATH 没刷新。用venv配合镜像源整个项目从环境搭建到依赖安装的完整流程可以拉得很顺。我个人的习惯是每个项目目录里放一个.gitignore把venv文件夹排除在版本控制之外——虚拟环境是本地配置不该提交到仓库里。至于项目依赖的统一管理最可靠的方式是把所有依赖写进requirements.txt让环境变更可复现# 把当前环境里所有已安装的包导出到文件 pip freeze requirements.txt这个命令会把所有包名和精确版本号写进requirements.txt。换一台机器或让别人接手项目时只需要执行pip install -r requirements.txt就能恢复出完全一致的依赖环境。注意pip freeze会包括依赖的依赖文件内容可能比你直接声明的包多出不少这属正常现象它保证的是完全可复现。5. 安装与配置常见问题排查5 个高频踩坑记录5.1 提示“python 不是内部或外部命令”现象在 Windows 终端输入python直接返回python 不是内部或外部命令也不是可运行的程序或批处理文件。原因有两个高频诱因。一是安装时没有勾选“Add Python to PATH”Python 的可执行文件路径没有写进系统环境变量二是安装时勾选了但安装完成后没有重新打开终端当前会话还保留着旧的 PATH 环境变量。解决先关掉终端重开再试一次。如果还是不行打开“系统属性 → 环境变量”在 Path 中手动添加 Python 安装目录及其 Scripts 子目录保存后重开终端。验证方法是在任意目录输入python --version如果不再提示找不到说明 PATH 生效了。5.2 装完 Python 后pip提示找不到现象python --version输出正常但输入pip --version提示找不到命令。原因Windows 上多是因为安装时取消了 pip 组件或者安装后 Scripts 目录没有加入 PATH。macOS 和 Linux 上则可能是命令名不匹配——pip 的可执行文件名是pip3你输入的是pip而系统里没有pip这个软链接。解决Windows 上重新运行安装程序选择 Modify 并勾选 pip 组件macOS/Linux 上先用pip3 --version确认可用再根据实际需求创建软链接或者干脆在命令行里习惯性使用pip3。不建议在 Linux 上为 pip 创建指向 pip3 的软链接因为某些发行版的系统包管理脚本会依赖原有的 pip 行为。5.3 终端里输入python3运行的却不是刚安装的版本现象刚装完 Pythonpython3 --version显示的版本号和安装的版本对不上。原因系统里存在多个 Python 安装。macOS 是因为系统自带了一份 Python 在/usr/bin下而新装的在/usr/local/bin下如果 PATH 中/usr/bin排在更前面命令命中的就是系统自带版本。Linux 也有类似情况尤其当你既用过包管理器又手动编译安装过 Python。解决执行which python3看清楚实际命中的路径。如果是/usr/bin/python3说明 PATH 顺序不对。在~/.bashrc或~/.zshrc中把新 Python 的目录路径加到前面或者直接使用新 Python 的完整路径。彻底排查方法是用ls -l查看/usr/local/bin/python3是否是指向新版本的软链接。5.4 pip 安装包时超时或速度极慢现象执行pip install命令后长时间停在下载阶段或者直接报Read timed out错误。原因pip 默认从官方源pypi.org下载国内网络环境下的连接速度不稳定大包特别明显。解决按前文方式配置镜像源。如果你已经配置了镜像源仍然慢检查配置是否真的被 pip 读取了执行pip config list查看当前生效的配置。另外注意某些公司网络环境可能屏蔽了外部源的 HTTPS 请求这种情况需要配合trusted-host配置来绕过对镜像站证书的额外校验。5.5 装了多个 Python 版本IDE 里用的是我不想用的那个现象项目代码在终端里运行正常但在 IDE 里运行时却报错缺少依赖查看解释器路径发现 IDE 用的是全局 Python而不是项目虚拟环境里的那个。原因IDE 默认会使用自己的解释器配置不会自动读取项目里的虚拟环境路径。很多 IDE 第一次打开项目时要求手动选择解释器如果当时随手选了全局 Python后面就一直用它跑。解决在 IDE 设置里把项目解释器指向虚拟环境路径。以常见的 IDE 为例在项目设置中找到 Python Interpreter 选项选择 Existing environment浏览到venv\Scripts\python.exeWindows或venv/bin/pythonmacOS/Linux。改完后运行项目的所有依赖解析和调试都会使用虚拟环境和终端行为保持一致。6. 从“装好”到“装对”把环境固化成一键可复用的方案安装 Python 只是起点真正决定开发效率的是把这套环境固化成一个可复用的工作流。我最常用的做法是把虚拟环境和依赖清单配合起来形成一个标准化的新项目初始化流程。首先是项目目录的结构。每个项目开始前按固定套路执行mkdir myproject cd myproject python -m venv venv source venv/bin/activate pip install -r requirements.txt这里的关键点是requirements.txt是预先准备好的。如果是从零开始的项目文件内容可以是空的等装完必要依赖后立即执行pip freeze requirements.txt从第一刻起就锁定依赖。如果是接手别人的项目仓库里通常已经有requirements.txt直接通过一条命令恢复环境。这个流程的好处在于环境搭建的耗时从“手工逐个安装”变成一个可重复执行的命令序列换机器、加队友、部署测试环境都是同一个操作。另一个值得养成的习惯是区分全局环境和项目环境。全局环境里只安装一些日常工具类的包比如代码格式化工具、静态检查工具这些工具型依赖不参与具体项目的运行逻辑。而项目相关的所有依赖一律进虚拟环境。这样做的意义在于避免全局环境被各种项目的依赖互相覆盖也减少依赖冲突的可能性。我曾经把几个项目的依赖全堆在全局环境里后来升级某个包时连带破坏了另一个项目教训深刻。升级 Python 小版本的时机也需要讲究。不要在一个项目进行到一半时顺手升级解释器那可能带来沙箱环境不一致和依赖不兼容的风险。常见的做法是等当前项目周期结束后在新建项目时再切换到新版本。切换前先确认核心依赖对目标版本的声明支持避免装完才发现某个关键库还不兼容又退回去的尴尬。最后装好 Python 后我建议你做一次完整的自检打开终端跑通python --version、pip --version、创建虚拟环境、激活、安装一个包、退出虚拟环境。全程不超过十分钟但能帮你把安装环节的每个细节都验证一遍。以后再遇到环境问题你能清楚地判断是安装层的问题还是使用层的问题排查路径会清晰很多。希望帮到你。本文还有配套的精品资源点击获取