Python 与 pip 排障笔记

2026-10-13

常用命令

pip freeze > requirements.txt
# 导出依赖软件包到当前目录

pip3 list        # 查看软件包列表
pip3 show <软件包>  # 查看软件包信息

如果要更改终端调用 python 的命令，找到对应路径下的 python.exe 重命名即可，然后重装 pip。

在指定路径查找软件包，在程序开头加入：

import sys
sys.path.append('<Python安装目录>\python_3.7\lib\site-packages')

pip 安装

pip2 安装参考：https://blog.csdn.net/huayimy/article/details/128338899

pip3 安装：

python3 get-pip3.py

pip 换源

国内镜像源

清华大学 TUNA 镜像源：https://pypi.tuna.tsinghua.edu.cn/simple
阿里云镜像源：http://mirrors.aliyun.com/pypi/simple/
中国科学技术大学镜像源：https://mirrors.ustc.edu.cn/pypi/simple/
华为云镜像源：https://repo.huaweicloud.com/repository/pypi/simple/
腾讯云镜像源：https://mirrors.cloud.tencent.com/pypi/simple/

指定源下载

pip install -i http://mirrors.aliyun.com/pypi/simple/ --upgrade pip --trusted-host mirrors.aliyun.com

pip install -i https://mirrors.ustc.edu.cn/pypi/simple/ --upgrade pip --trusted-host mirrors.ustc.edu.cn
# 全面，优先使用

全局换源

配置文件位置示例：C:\Users\用户名\venv\Lib\site-packages\pip 下的 pip.ini。

或用命令行设置：

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

升级 pip

pip install --upgrade pip

查看已安装的软件包

pip list

示例输出：

pip2：Python 2.7.18
pip                           20.3.4
setuptools                    18.5

pip3：Python 3.11.9
setuptools                     68.1.2
pip                            24.1.1

本地安装软件包

从 https://pypi.org/ 搜索对应软件包下载到本地后：

pip3 install "/home/kali/桌面/docker_compose-1.29.2-py2.py3-none-any.whl"

kali 下软件包路径：/usr/lib/python2.7/dist-packages/、/home/kali/.local/lib/python2.7/site-packages/。

常见报错排障

脚本运行失败

  • 安装对应的依赖包（import），或用 python .py 运行脚本查看报错
  • 网上搜索报错信息，安装对应的软件包
  • 尽量不修改源码，如需修改先用 # 注释源码，再新增一行修改（方便复原）
  • 如果遇到找不到对应软件包（名字对不上），在 site-packages 文件夹中修改名称，例如 crypto 改为 Crypto 后重新运行
  • Windows 下尝试多次失败，可更换环境再试（如 kali）

PIP 报错 externally-managed-environment

去掉提示：

sudo mv /usr/lib/python3.x/EXTERNALLY-MANAGED /usr/lib/python3.x/EXTERNALLY-MANAGED.bk
# 3.x 替换为实际 python 版本，如 3.12

原文链接：https://blog.csdn.net/xiaokk/article/details/139485697

SYNTAXERROR: NON-ASCII CHARACTER '\XE4' IN FILE

代码最顶部加一句 #coding:utf-8。

IndentationError: unexpected indent

python 是一种对缩进非常敏感的语言，最常见的情况是 tab 和空格混用导致错误，或者缩进不对。

pip: Fatal error in launcher: Unable to create process

原因：更改了 python 的安装路径并修改了环境变量，pip 程序内写死了 python 路径，更改后无法找到 python 程序。

解决：终端下重装对应 python 版本的 pip 即可：

python2.7 -m pip install -U --force-reinstall pip

crypto.cipher 报错

pip uninstall crypto
pip uninstall pycryptodome
pip install pycryptodome
# 前两个卸载命令是为了防止安装环境问题

← 返回文章列表