pip
pip 是 Python 的官方包安装程序，它是安装和管理 Python 模块（也称为包或库）的标准工具，当你安装 Python 时，pip 通常会自动一起安装。
使用命令行（最常用、最推荐）
这是最标准、最灵活的方法,适用于所有情况。
打开命令行工具
在 Windows 上,你有几个选择：
- 命令提示符：最基础的工具。
- PowerShell：更现代、更强大的工具,推荐使用。
- Windows Terminal：一个集成了 CMD、PowerShell 和 WSL 的终端应用,体验最好。
如何打开：
按下键盘上的 Win + R 键，输入 cmd 或 powershell，然后按回车,或者直接在开始菜单搜索并打开。
检查 pip 是否已安装
在打开的命令行窗口中,输入以下命令并按回车：
pip --version
或者，如果你有多个 Python 版本，可能会用到 pip3：
pip3 --version
如果看到类似 pip 23.2.1 from ... 的输出，说明 pip 已经安装好了，如果提示 'pip' 不是内部或外部命令...，请参考文末的【常见问题与解决方案】。
使用 pip 安装模块
基本语法非常简单：
pip install 模块名
示例：
-
安装一个模块：安装一个非常流行的数据处理库
pandas。pip install pandas
pip会自动从 Python 官方包仓库 PyPI 下载并安装pandas及其所有依赖项。 -
安装特定版本的模块：如果你的项目需要特定版本的模块。
pip install requests==2.28.1
-
升级已安装的模块：将已安装的模块升级到最新版本。
pip install --upgrade 模块名
pip install --upgrade numpy -
卸载模块：
pip uninstall 模块名
pip uninstall pandas -
查看已安装的模块列表：
pip list
使用 IDE（集成开发环境）
如果你使用的是像 PyCharm、VS Code 这样的现代 IDE，它们通常提供了图形化的界面来安装和管理模块,这会让初学者更友好。
在 PyCharm 中安装
- 打开你的项目。
- 在右下角找到
Python Packages标签页。 - 在搜索框中输入你想要安装的模块名（
flask）。 - 点击左侧的 号（或
Install按钮）。 - PyCharm 会在后台自动调用
pip来完成安装，安装成功后,模块会出现在列表中。
在 Visual Studio Code (VS Code) 中安装
VS Code 本身不直接管理包，但它与强大的 Python 扩展无缝集成。
- 前提：确保你已经安装了 Python 扩展。
- 方法一（使用命令面板）：
- 按
Ctrl+Shift+P打开命令面板。 - 输入
Python: Select Interpreter，选择你项目使用的 Python 环境。 - 再次打开命令面板，输入
Python: Create Terminal，这会为你打开一个已经配置好 Python 环境的终端。 - 在这个新终端里，直接使用
pip install 模块名命令。
- 按
- 方法二（使用资源管理器）：
- 在 VS Code 的左侧活动栏，点击
扩展图标。 - 在搜索框中输入
Python，确保已安装并启用 Microsoft 的 Python 扩展。 - 切换到
Python 扩展的管理页面，在INSTALLED PACKAGES部分，你可以看到已安装的包，并有一个 按钮可以用来搜索和安装新包。
- 在 VS Code 的左侧活动栏，点击
重要概念：虚拟环境
这是 Python 开发中极其重要的一个最佳实践。
什么是虚拟环境？
虚拟环境就像一个独立的、隔离的 Python 工作区，它允许你为每个项目创建一套独立的 Python 包集合，而不会影响系统全局的 Python 环境或其他项目。
为什么需要它？
- 避免版本冲突：项目 A 需要
requests==2.25.0，而项目 B 需要requests==2.28.1，如果没有虚拟环境，这两个版本会互相覆盖,导致程序出错。 - 保持项目整洁：所有项目相关的包都只存在于该项目的虚拟环境中,便于管理和迁移。
- 简化部署：可以轻松地导出项目所需的所有包及其版本,方便在另一台电脑上重现环境。
如何在 Windows 上创建和使用虚拟环境？
我们以命令行方式为例（IDE 通常也支持一键创建）。
-
创建虚拟环境 在你的项目文件夹下（
my_project），打开命令行,运行：# my_project 是虚拟环境的文件夹名，你可以自定义 python -m venv my_project_env
执行后，你的项目文件夹下会出现一个新的
my_project_env文件夹，里面包含了独立的 Python 解释器和pip。 -
激活虚拟环境 虚拟环境在使用前必须先“激活”，激活后，你的命令行提示符前面会出现环境名，
(my_project_env) C:\Users\YourUser\...>。- 在 CMD 中：
my_project_env\Scripts\activate.bat
- 在 PowerShell 中：
.\my_project_env\Scripts\Activate.ps1
注意：如果第一次在 PowerShell 中使用
Activate.ps1，可能会因为执行策略而失败，需要以管理员身份打开 PowerShell，然后运行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser来修改策略。
- 在 CMD 中：
-
在虚拟环境中安装模块 激活虚拟环境后，你之前使用的所有
pip命令现在都只对这个虚拟环境有效。# (my_project_env) C:\...> 提示符下执行 pip install django
你会发现
django只被安装到了my_project_env\Lib\site-packages目录下，而不会污染你的全局 Python 环境。 -
退出虚拟环境 当你完成工作后,只需输入：
deactivate
提示符会恢复原样。
常见问题与解决方案
问题 1：'pip' 不是内部或外部命令...
这通常意味着 Windows 的系统环境变量 PATH 中没有包含 Python 和 pip 的路径。
解决方案：
- 找到你的 Python 安装路径，通常在
C:\Users\你的用户名\AppData\Local\Programs\Python\PythonXX\或C:\PythonXX\。 - 将以下两个路径添加到系统的
PATH环境变量中：C:\...\PythonXX\(Python 的根目录)C:\...\PythonXX\Scripts\(存放pip.exe,python.exe等工具的目录)
- 重启命令行窗口，再次尝试
pip --version。
问题 2：权限错误（Access is denied）
当你尝试在全局（非虚拟环境）安装模块时，可能会遇到此错误,这是因为安装需要管理员权限。
解决方案：
- 以管理员身份运行命令行：在开始菜单搜索
cmd或powershell，右键点击，选择“以管理员身份运行”。 - 然后再执行
pip install命令。 - 最佳实践：强烈建议使用虚拟环境,这样就不需要管理员权限了。
问题 3：网络问题（连接超时、Read timed out）
在国内访问 PyPI 服务器有时会很慢或失败。
解决方案： 使用国内镜像源，国内许多云服务商都提供了 PyPI 镜像。
-
临时使用（在
install命令后加上-i参数）：pip install 模块名 -i https://pypi.tuna.tsinghua.edu.cn/simple
常用的镜像源：
- 清华大学：
https://pypi.tuna.tsinghua.edu.cn/simple - 阿里云：
https://mirrors.aliyun.com/pypi/simple/ - 豆瓣：
https://pypi.douban.com/simple/
- 清华大学：
-
永久配置（推荐）： 在用户目录下创建一个
%APPDATA%\pip\pip.ini文件（如果目录不存在就创建）,并写入以下内容：[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple
这样之后所有
pip命令都会默认使用清华源。
| 任务 | 推荐方法 | 命令 / 操作 |
|---|---|---|
| 安装模块 | 命令行 | pip install 模块名 |
| 卸载模块 | 命令行 | pip uninstall 模块名 |
| 升级模块 | 命令行 | pip install --upgrade 模块名 |
| 查看列表 | 命令行 | pip list |
| 最佳实践 | 使用虚拟环境 | python -m venv env_name -> env_name\Scripts\activate |
| 国内加速 | 配置镜像源 | 创建 %APPDATA%\pip\pip.ini 文件 |
对于初学者,建议遵循以下流程：
- 为每个项目创建一个项目文件夹。
- 在文件夹内创建并激活一个虚拟环境。
- 在激活的虚拟环境中使用
pip安装项目所需的模块。 - 开发完成后,退出虚拟环境。
