python pip使用教程

pip更换源

pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/

::: tips 方法二：创建pip.ini配置文件 请在用户根目录下创建pip文件夹，并在pip文件夹下创建pip.ini文件。
Windows路径为C:\Users\username\pip\pip.ini，Linux路径为~/.pip/pip.ini。

[global]
index-url=https://mirrors.aliyun.com/pypi/simple/ 

[install]
trusted-host=mirrors.aliyun.com

::: 其他pip源如下：

• https://mirrors.aliyun.com/pypi/simple/
• https://pypi.douban.com/simple/
• https://pypi.tuna.tsinghua.edu.cn/simple/

pip操作

pip install django -i https://mirrors.aliyun.com/pypi/simple/  # 指定镜像源安装
pip install tornado==5.1.1  # 安装指定版本包
pip install git+https://github.com/istommao/django-simditor.git  # pip+git安装方式
pip install --force-reinstall django  # 删除重装，删除以前包再重新安装
pip install --ignore-installed django  # 强制覆盖安装，直接强制覆盖安装，简写是'-I'

# 查看本地的包
pip list  # 列出已安装的所有包
pip show django  # 查看本地某个包

# 查看可以升级的包
pip list --outdate

# 升级某个包
pip install --upgrade django

# 升级所有包（Windows）
pip list --outdated | ForEach-Object { pip install --upgrade $_.split()[0] }
  
# 卸载包
pip uninstall django

# 删除环境中所有包
pip freeze | xargs pip uninstall -y


# 导出当前环境包信息到文件
# 方法一：这种会将环境依赖包全部都加入，全局环境会加载所有包。仅适合于单虚拟环境下运行
pip freeze list > requirements.txt.bak
# 方法二（推荐）：结合全局环境所安装的包，去分析项目代码import语句，仅加载项目需要的包。（注意全局环境必须把依赖包全装上）
pip install pipreqs
pipreqs . --encoding=utf8 --force --pypi-server https://pypi.tuna.tsinghua.edu.cn/simple/  # 会强行替换requirements.txt文件，注意备份

第三方pip包功能

# 搜索远程的包
pip install pip-search
pip_search aliyun*
pip_search django

# 树状结构显示依赖
pip install pipdeptree
pipdeptree

# 检查包版本状况
pip install pigar
pigar check

# 根据项目自动创建requirements.txt
pip install pipreqs
pipreqs

# 升级所有包（方法一）
pip install pip-review
pip-review --local --auto  # 请使用管理员权限

pipx

pipx在安装某个包时会使用独立环境，用于安装软件或工具的，而用于编程开发使用。
PIPX 安装教程

# 安装
scoop install pipx
pipx ensurepath  # 自动配置path
pipx install argcomplete  # pipx自动补全工具

pipx completions
# 安装工具
pipx install poetry --verbose
pipx ensurepath

生成固定版本的requirements.txt文件

pip install pip-tools
pip-compile --upgrade --no-header --no-annotate requirements.txt -o requirements-upgraded.txt
mv requirements.txt requirements.bak.txt
mv requirements-upgraded.txt requirements.txt

提示

如果条件允许，不太建议requirements.txt文件中固定版本号。
推荐方式一：django~=3.2.10
推荐方式二：django>=3.2.10,<=3.99.99 ``

注意

非常建议使用管理员权限命令行，不然安装某些包时会有莫名其妙错误。

除非指定了 --upgrade，否则 pip install 倾向于保持已安装的版本不变。

Windows下安装某些包报错

在Windows环境如果安装某些包报错，可以在这个网站手动下载Windows版的包进行安装

包安装示例

mysqlclient

Ubuntu22.04

sudo apt install libmysqlclient-dev
pip install mysqlclient

报错指南

注意

WARNING: Ignoring invalid distribution -XXXX (c:\python310\lib\site-packages)

该警告原因可能是之前下载库的时候没有成功或者中途退出，在site-packages中找到~XXXX开头的目录并删除。