piplist与pipfreeze区别详解

本文深入解析了Python中`pip list`与`pip freeze`这两个看似相似实则语义迥异的命令：`pip list`真实反映当前环境“能导入什么”，但默认隐藏可编辑安装包；而`pip freeze`专注生成“可精确复现安装”的依赖快照，强制输出`name==version`格式并主动忽略VCS链接、本地路径及可编辑包——正因这一根本差异，误用`pip list`生成requirements.txt常导致部署失败。文章不仅厘清核心区别，还直击Windows中文乱码、虚拟环境未激活误判、私有源信息丢失、跨平台兼容等高频痛点，并给出即学即用的实操方案，帮你避开那些不踩一次就永远记不住的“静默陷阱”。

pip list 显示的是当前环境里所有可导入的包

它读取的是 Python 环境 site-packages 下已安装的包信息，但会过滤掉“可编辑安装”（pip install -e）的包，除非你加 --all 参数。如果你用 pip install -e ./mylib 开发一个本地库，pip list 默认看不到它——这常让人误以为没装上。

实操建议：

• 查当前环境真实可用的包，用 pip list；想看包括可编辑安装的完整列表，加 --all
• 如果用了虚拟环境但输出里还有大量系统级包（比如 setuptools、wheel），说明可能没激活环境，或者用了 --system 安装方式
• pip list --outdated 能快速定位哪些包有新版本，但注意它不检查依赖树里的间接依赖是否过期

pip freeze 只输出「可复现安装」所需的包格式

pip freeze 的核心作用不是“列出”，而是“导出可用于 pip install -r 的精确依赖”。它强制把每个包写成 name==version 形式，并忽略非 PyPI 安装源（如 VCS 链接、本地路径、可编辑包），除非你加 --all。

常见错误现象：在项目根目录运行 pip freeze > requirements.txt，结果部署时 pip install -r requirements.txt 报错说找不到某个包——大概率是因为那个包是 pip install -e git+https://... 装的，pip freeze 直接跳过了它。

实操建议：

• 生成生产环境 requirements.txt，优先用 pip freeze，但务必人工补全 VCS 或本地依赖项
• 如果项目依赖了私有索引（如 Nexus、Artifactory），pip freeze 不会保留 --index-url 信息，后续安装需额外指定
• pip freeze --exclude-editable（Python 22.2+）可显式排除可编辑包，比默认行为更可控

两者输出差异直接影响 requirements.txt 是否能重装成功

pip list 和 pip freeze 输出结构不同：pip list 是对齐表格，pip freeze 是等号分隔的纯文本行。更重要的是语义差异——pip list 回答“我有什么”，pip freeze 回答“我该怎么被重新装出来”。

使用场景举例：CI 流水线中自动生成依赖文件时，有人误用 pip list > reqs.txt，结果 pip install -r reqs.txt 失败，因为 pip list 输出含表头和空格，且版本号不带 ==。

实操建议：

• 永远别用 pip list > requirements.txt 替代 pip freeze > requirements.txt
• 若需冻结子依赖（即递归列出所有传递依赖），pip freeze 本身不支持，得靠 pipdeptree --freeze 或 pipreqs
• 在多环境协作中，pip freeze 输出不含平台信息（如 pywin32 只在 Windows 有效），跨平台共享前需手动加环境标记，例如 pywin32==306; platform_system == "Windows"

Windows 上 pip list 中文包名显示乱码怎么办

这不是命令本身的问题，而是 Windows 控制台默认编码（GBK）与 pip 输出 UTF-8 冲突。典型表现是 pip list 里带中文作者名或描述的包名显示为 符号，但包本身能正常 import。

根本原因在于 Python 3.7+ 的 pip 默认以 UTF-8 输出，而 cmd/powershell 在非 UTF-8 模式下无法正确渲染。

实操建议：

• 临时解决：在命令行先运行 chcp 65001（切换到 UTF-8 编码），再执行 pip list
• 一劳永逸：在 PowerShell 中设置 $OutputEncoding = [System.Text.Encoding]::UTF8，并加入配置文件 $PROFILE
• 不影响功能：乱码只发生在显示层，pip list --format=json 输出始终是标准 JSON，适合脚本解析

实际用的时候，最麻烦的从来不是记不清哪个命令该用，而是忘了 pip freeze 会悄悄扔掉你用 -e 装的开发包，或者在 Windows 上看到一堆 还以为环境坏了。这些点不踩一次，很难真记住。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《piplist与pipfreeze区别详解》文章吧，也可关注golang学习网公众号了解相关技术文章。