【超详细零基础】Python环境搭建教程(Windows+Linux)+多版本切换保姆级攻略
对于编程新手来说搭建Python环境是入门第一步也是最容易踩坑的环节。本文全程零基础适配详细讲解Windows、Linux双系统的Python下载、安装、环境配置、版本验证方法同时补充新手必备的版本管理工具nvm的完整用法解决多Python版本共存、版本切换冲突问题全程手把手操作看完即可一次性搭建成功。一、前期基础说明1. 版本选择建议优先选择Python3.9~3.12稳定版兼容性最强适配绝大多数爬虫、数据分析、后端开发场景不建议新手直接使用最新测试版或老旧Python2版本已停止维护。2. 核心原则所有Python安装包均从官方网站下载杜绝第三方修改安装包避免病毒、环境异常问题。二、Windows系统Python环境搭建Win10/Win11通用1. 官方下载Python安装包第一步打开Python官方下载地址https://www.python.org/downloads/windows/第二步下滑找到Stable Releases稳定版本根据电脑系统位数选择安装包64位系统目前绝大多数电脑下载Windows Installer (64-bit)32位老旧系统下载Windows Installer (32-bit)Tips可右键「此电脑-属性」查看系统位数新手直接下载3.11、3.12版本即可。2. 安装Python关键步骤1. 右键下载好的exe安装包选择以管理员身份运行避免权限不足导致安装失败。2. 安装界面必须勾选左下角【Add Python 3.x to PATH】核心自动配置环境变量跳过这一步会导致后续无法识别python命令。3. 新手推荐选择Install Now默认安装自动安装到系统默认目录无需手动配置路径需要自定义安装位置可选择Customize installation。4. 等待进度条走完点击「Close」完成安装。3. 验证安装成功查看Python版本1. 按下快捷键WinR输入cmd回车打开命令提示符窗口。2. 输入以下任意一条命令回车执行输出版本号即代表安装配置成功python --version # 或简写 python -V示例成功输出Python 3.11.63. 同时可验证pip工具Python包管理工具自带无需额外安装输入命令pip --version三、Linux系统Python环境搭建Ubuntu/CentOS通用Linux系统大多预装Python但默认版本老旧需手动安装新版并配置以下是主流发行版通用教程。1. Ubuntu/Debian 系统安装打开终端快捷键CtrlAltT依次输入以下命令每行输入完成回车执行# 1. 更新系统软件源列表 sudo apt update # 2. 安装Python3及自带pip工具 sudo apt install -y python3 python3-pip # 3. 验证版本 python3 --version pip3 --version2. CentOS/RHEL 系统安装# CentOS8 版本 sudo dnf install -y python3 python3-pip # CentOS7 版本 sudo yum install -y python3 python3-pip # 验证版本 python3 --version3. Linux环境简单配置说明Linux系统安装后自动配置环境变量无需手动修改配置文件。新手可设置python默认指向python3输入命令alias pythonpython3设置后直接输入python --version即可查看版本和Windows操作统一。四、nvm工具详解Python多版本管理神器很多新手都会踩一个大坑电脑装了Python3.9新项目需要Python3.11重装就会覆盖旧版本导致旧项目报错、环境彻底崩掉。这里纠正90%新手的误区nvm不管理Pythonnvm是Node.js版本管理工具Python需要用专用工具pyenvLinux/Mac、pyenv-winWindows。我将在下文通俗讲清区别、nvm用途同时附赠Python真正的多版本切换方案彻底解决版本冲突问题。1. nvm是什么nvm 全称 Node Version ManagerNode版本管理工具核心作用是管理 Node.js 版本前端开发必备。重要结论✅ nvm 管理Node.js版本✅ Python多版本管理 pyenv / pyenv-win❌ nvm不能管理、切换Python版本原教程误区修正很多新手网上抄教程混淆两者导致装了nvm依然无法切换Python版本本文帮你彻底避坑。2. 为什么大家都会混淆nvmnvm的真实用途场景混淆原因nvm是最流行的语言版本管理工具很多教程不区分场景错误宣称可以管理Python误导大量新手。nvm核心价值前端开发多项目依赖不同Node版本nvm实现一键切换、环境隔离、无需重复安装。学习建议如果你做前端必装nvm如果你只学Python无需装nvm直接用pyenv系列工具即可。通用优势版本管理工具统一解决「版本冲突、环境混乱、重装覆盖」三大痛点是编程入门必备技能。3. Windows系统nvm安装教程仅Node.js使用1. 下载nvm安装包官网地址 https://github.com/coreybutler/nvm-windows/releases2. 下滑找到最新版下载nvm-setup.exe安装程序3. 双击安装全程默认下一步即可自动配置环境变量4. 打开cmd输入命令验证nvm安装成功nvm version4. Linux系统nvm安装教程仅Node.js使用终端输入一键安装命令通用所有Linux发行版curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash安装完成后重启终端输入nvm --version验证。5. 补充Python正确多版本切换方案替代nvm新手不用nvm管理Python以下是Windows/Linux通用的Python多版本最优解简单好上手Windows用户pyenv-win 核心命令# 查看可安装Python版本 pyenv install --list # 安装指定版本 pyenv install 3.11.6 # 查看已安装版本 pyenv versions # 全局切换版本 pyenv global 3.11.6 # 局部项目切换版本 pyenv local 3.9.13Linux用户pyenv 核心命令# 安装依赖 sudo apt install git curl build-essential # 安装pyenv curl https://pyenv.run | bash # 重载环境 source ~/.bashrc # 版本操作命令和Windows完全一致 pyenv install 3.11 pyenv global 3.11所有命令均在命令行/终端执行新手熟记以下核心命令即可五、新手常见报错排查输入python命令提示「不是内部或外部命令」Windows安装时未勾选PATH环境变量重新运行安装包修复或手动配置环境变量nvm命令失效关闭当前命令行重新打开终端即可生效Linux安装报错权限不足命令前添加sudo赋予管理员权限六、总结1、Windows搭建核心官网下载正式稳定版安装时务必勾选PATH环境变量安装后通过python --version验证解决90%环境识别报错2. Linux安装核心系统包管理器一键安装自动配置环境变量操作更简洁3、版本工具避坑nvm只管Node.js不管PythonPython多版本共存请使用pyenv工具彻底告别版本冲突、环境错乱问题新手入门直接用这套标准方案。