0

0

python环境变量的配置 | 详细图解Python环境变量设置流程

煙雲

煙雲

发布时间:2026-01-30 20:40:01

|

245人浏览过

|

来源于php中文网

原创

Python命令找不到是因安装路径未加入PATH环境变量,需手动将Python主目录及Scripts目录添加至PATH,并重启终端验证。

python环境变量的配置 | 详细图解python环境变量设置流程

Python 环境变量没配对,python 命令就找不到解释器,pip 也装不了包——这不是 Python 本身的问题,而是系统压根不知道你把 Python 装哪儿了。

为什么 pythonpip 在终端里报“命令未找到”

Windows、macOS、Linux 都靠 PATH 环境变量决定哪些目录下的可执行文件能被直接调用。如果你装了 Python,但安装路径(比如 C:\Users\Name\AppData\Local\Programs\Python\Python312\/usr/local/bin)没加进 PATH,终端就搜不到 python.exepython3

  • 常见错误现象:'python' is not recognized as an internal or external command(Windows),或 command not found: python3(macOS/Linux)
  • 不是重装 Python 就能解决——很多安装器默认不勾选“Add Python to PATH”,尤其 Windows 上容易漏掉
  • macOS 使用 Homebrew 安装的 Python3,二进制通常在 /opt/homebrew/bin/python3(Apple Silicon)或 /usr/local/bin/python3(Intel),这个路径必须出现在 PATH 开头或靠前位置,否则可能被系统自带的 Python2.7 覆盖

Windows 上怎么正确添加 Python 到 PATH

别依赖安装时的勾选项——它有时失效,或者你后来换了 Python 版本。手动加最稳。

  • 先确认 Python 安装路径:打开文件资源管理器,进入 Python 安装目录(例如 C:\Users\Name\AppData\Local\Programs\Python\Python312\),里面必须有 python.exeScripts\pip.exe
  • 右键“此电脑” → “属性” → “高级系统设置” → “环境变量” → 在“系统变量”里双击 Path → “新建” → 粘贴完整 Python 安装路径(如 C:\Users\Name\AppData\Local\Programs\Python\Python312\)→ 再新建一行,粘贴 Scripts 路径(如 C:\Users\Name\AppData\Local\Programs\Python\Python312\Scripts\
  • 改完后必须关掉所有已打开的命令行窗口,重新开一个 cmd 或 PowerShell 再测试:python --versionpip --version
  • 如果仍不行,检查是否误加了尾部反斜杠(\)——Windows 对路径末尾斜杠敏感,C:\Python312\ 是错的,应为 C:\Python312

macOS/Linux 怎么让 python3 变成 python

系统默认 python 指向 Python2(尤其 macOS),而你装的是 Python3。硬改系统链接风险大,推荐用 shell 别名或 PATH 优先级控制。

php配置文件php.ini的中文注释版
php配置文件php.ini的中文注释版

php配置文件php.ini的中文注释版是一本由多位作者编著的有关PHP内部实现的开源书籍。从环境准备到代码实现,从实现过程到细节延展,从变量、函数、对象到内存、Zend虚拟机…… 如此种种,道尽PHP之风流。

下载

立即学习Python免费学习笔记(深入)”;

  • 先查清楚你真正想用的 Python3 路径:which python3(常见输出:/opt/homebrew/bin/python3/usr/local/bin/python3
  • 编辑 shell 配置文件:~/.zshrc(macOS Catalina 及以后默认)或 ~/.bash_profile(旧版或 Linux),追加一行:export PATH="/opt/homebrew/bin:$PATH"(Homebrew 用户)或 export PATH="/usr/local/bin:$PATH"
  • 别写 alias python=python3 ——很多工具(如 pipvenv)会读取 #!/usr/bin/env python 这类 shebang,别名不生效;只有修改 PATH 才能让所有子进程都识别
  • 改完运行 source ~/.zshrc,再验证:which python 应该输出你期望的路径,且 python --version 显示 3.x

验证和排错的关键命令

别只信“看起来能跑”,要逐层确认路径解析是否真按你预期走。

  • echo $PATH(macOS/Linux)或 echo %PATH%(Windows CMD):看目标路径是否真的在里面,顺序是否合理
  • where python(Windows CMD)或 which python(macOS/Linux):查当前实际调用的是哪个可执行文件
  • python -c "import sys; print(sys.executable)":确认 Python 解释器自身加载的是哪个路径——这比 which 更权威,因为可能被 virtualenv 或 pyenv 干扰
  • 如果用了 pyenvconda,它们会接管 PATH,此时不要手动改系统 PATH,而是用 pyenv global 3.12.0conda activate base 来切换

环境变量是隐式依赖,改一次能管很久,但一旦出问题,排查链路长、干扰因素多——最稳妥的做法是每次换新机器或重装系统后,第一件事就是用 which pythonpython -c "import sys; print(sys.executable)" 对齐两个路径,再继续装包或写代码。

相关文章

python速学教程(入门到精通)
python速学教程(入门到精通)

python怎么学习?python怎么入门?python在哪学?python怎么学才快?不用担心,这里为大家提供了python速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

339

2023.10.09

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

416

2024.12.20

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

761

2024.12.23

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

349

2025.07.23

python中print函数的用法
python中print函数的用法

python中print函数的语法是“print(value1, value2, ..., sep=' ', end=' ', file=sys.stdout, flush=False)”。本专题为大家提供print相关的文章、下载、课程内容,供大家免费下载体验。

186

2023.09.27

python中print函数的用法
python中print函数的用法

python中print函数的语法是“print(value1, value2, ..., sep=' ', end=' ', file=sys.stdout, flush=False)”。本专题为大家提供print相关的文章、下载、课程内容,供大家免费下载体验。

186

2023.09.27

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

810

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1129

2023.07.27

C++ 设计模式与软件架构
C++ 设计模式与软件架构

本专题深入讲解 C++ 中的常见设计模式与架构优化,包括单例模式、工厂模式、观察者模式、策略模式、命令模式等,结合实际案例展示如何在 C++ 项目中应用这些模式提升代码可维护性与扩展性。通过案例分析,帮助开发者掌握 如何运用设计模式构建高质量的软件架构,提升系统的灵活性与可扩展性。

14

2026.01.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 8.1万人学习

Git 教程
Git 教程

共21课时 | 3.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号