对于编程新手来说,搭建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. 按下快捷键Win+R,输入 cmd 回车,打开命令提示符窗口。

2. 输入以下任意一条命令,回车执行,输出版本号即代表安装+配置成功:

python --version
# 或简写
python -V

示例成功输出:Python 3.11.6

3. 同时可验证pip工具(Python包管理工具,自带无需额外安装),输入命令:

pip --version

三、Linux系统Python环境搭建(Ubuntu/CentOS通用)

Linux系统大多预装Python,但默认版本老旧,需手动安装新版并配置,以下是主流发行版通用教程。

1. Ubuntu/Debian 系统安装

打开终端(快捷键Ctrl+Alt+T),依次输入以下命令,每行输入完成回车执行:

# 1. 更新系统软件源列表
sudo apt update
# 2. 安装Python3及自带pip工具
sudo apt install -y python3 python3-pip
# 3. 验证版本
python3 --version
pip3 --version

2. CentOS/RHEL 系统安装

# CentOS8+ 版本
sudo dnf install -y python3 python3-pip
# CentOS7 版本
sudo yum install -y python3 python3-pip
# 验证版本
python3 --version

3. Linux环境简单配置说明

Linux系统安装后自动配置环境变量,无需手动修改配置文件。新手可设置python默认指向python3,输入命令:

alias python=python3

设置后直接输入 python --version 即可查看版本,和Windows操作统一。

四、nvm工具详解(Python多版本管理神器)

很多新手都会踩一个大坑:电脑装了Python3.9,新项目需要Python3.11,重装就会覆盖旧版本,导致旧项目报错、环境彻底崩掉。这里纠正90%新手的误区:nvm不管理Python!
nvm是Node.js版本管理工具,Python需要用专用工具pyenv(Linux/Mac)、pyenv-win(Windows)
我将在下文通俗讲清区别、nvm用途,同时附赠Python真正的多版本切换方案,彻底解决版本冲突问题。

1. nvm是什么?

nvm 全称 Node Version Manager(Node版本管理工具),核心作用是 管理 Node.js 版本,前端开发必备。
重要结论:

  • ✅ nvm = 管理 Node.js 版本

  • ✅ Python多版本管理 = pyenv / pyenv-win

  • ❌ nvm 不能管理、切换Python版本(原教程误区修正)

很多新手网上抄教程混淆两者,导致装了nvm依然无法切换Python版本,本文帮你彻底避坑。

2. 为什么大家都会混淆nvm?nvm的真实用途

  • 场景混淆原因:nvm是最流行的语言版本管理工具,很多教程不区分场景,错误宣称可以管理Python,误导大量新手。

  • nvm核心价值:前端开发多项目依赖不同Node版本,nvm实现一键切换、环境隔离、无需重复安装。

  • 学习建议:如果你做前端,必装nvm;如果你只学Python,无需装nvm,直接用pyenv系列工具即可。

  • 通用优势:版本管理工具统一解决「版本冲突、环境混乱、重装覆盖」三大痛点,是编程入门必备技能。

3. Windows系统nvm安装教程(仅Node.js使用)

1. 下载nvm安装包:官网地址 https://github.com/coreybutler/nvm-windows/releases

2. 下滑找到最新版,下载 nvm-setup.exe 安装程序

3. 双击安装,全程默认下一步即可,自动配置环境变量

4. 打开cmd,输入命令验证nvm安装成功:

nvm version

4. 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.13
Linux用户: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,不管Python!Python多版本共存请使用pyenv工具,彻底告别版本冲突、环境错乱问题,新手入门直接用这套标准方案。

Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐