必须配置环境变量和pip国内源:将Python安装目录及Scripts路径添加到PATH,再用pip config命令设置清华镜像源,最后验证python/pip版本和pip config list输出。

在Windows系统中让python和pip命令能在任意位置运行,同时确保安装第三方包时不卡在下载环节,必须完成环境变量配置和pip国内源设置两件事。
确认Python安装路径并添加到PATH
打开文件资源管理器,进入Python安装目录(例如D:\Python312),确认该目录下存在python.exe和Scripts子目录;Scripts目录里应有pip.exe、pip3.exe等可执行文件。
右键“此电脑”→“属性”→“高级系统设置”→“环境变量”,在“系统变量”区域找到Path,点击“编辑”→“新建”,粘贴Scripts目录的完整路径(如D:\Python312\Scripts)。
再新建一行,粘贴Python主目录路径(如D:\Python312)——【这两条路径缺一不可:前者让pip可用,后者让python可用】。
立即学习“Python免费学习笔记(深入)”;
点击全部“确定”保存。注意:已打开的命令提示符窗口不会自动加载新PATH,必须关闭后重新打开cmd或PowerShell。
验证环境变量是否生效
按Win+R输入cmd,回车后执行:
python --version
pip --version
若均显示版本号(如Python 3.15.1、pip 24.3.1),说明配置成功;若提示“不是内部或外部命令”,请返回上一步检查路径是否拼写错误、是否漏掉Scripts目录、是否未重启终端。
配置pip国内镜像源(提速关键)
方法一:一键命令配置(推荐,无需手动建文件)
在cmd中依次执行以下三条命令(每条单独回车):
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn
模板驱动的多平台内容流水线,面向独立 iOS 开发者,自动生成并排期一周的社交媒体帖子(TikTok、YouTube Shorts、X/Twitter...)
pip config set global.timeout 120
方法二:手动创建pip.ini配置文件
按下Win+R,输入%APPDATA%\pip,回车——若提示文件夹不存在,直接新建名为pip的文件夹;在其中新建文本文档,重命名为pip.ini(确保扩展名是.ini,不是.txt);用记事本打开,粘贴以下内容并保存:
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
timeout = 120
方法三:临时使用镜像(仅本次生效)
安装包时加参数:pip install requests -i https://mirrors.aliyun.com/pypi/simple/
检查pip源配置结果
执行命令:
pip config list
输出中必须包含global.index-url = https://pypi.tuna.tsinghua.edu.cn/simple这一行,才表示配置已写入生效。
如果输出为空或报错“no such file”,说明pip.ini路径错误或权限受限,优先改用方法一重新执行。

















