杰瑞科技汇

PyCharm如何安装Python模块?

使用 PyCharm 的图形界面(最推荐新手)

这是最直观、最简单的方法,适合所有用户,特别是初学者,它能够自动管理虚拟环境,避免版本冲突。

PyCharm如何安装Python模块?-图1
(图片来源网络,侵删)

步骤:

  1. 打开设置/偏好设置

    • 在 Windows 或 Linux 上,点击菜单栏的 File -> Settings
    • 在 macOS 上,点击菜单栏的 PyCharm -> Preferences
  2. 进入项目解释器设置

    • 在弹出的窗口中,导航到 Project: [你的项目名] -> Python Interpreter
    • 你会看到一个已安装包的列表,以及一个 号按钮。
  3. 搜索并安装新包

    • 点击列表左下角的 号按钮(Install Package)。
    • 这时会弹出一个 "Available Packages" 窗口,在顶部的搜索框中输入你想安装的包名,requestspandas
    • 搜索结果会显示出来,你可以选择需要的包,如果需要指定版本,可以点击版本号旁边的下拉箭头。
  4. 确认安装

    PyCharm如何安装Python模块?-图2
    (图片来源网络,侵删)
    • 选择好包后,点击左下角的 Install Package 按钮。
    • PyCharm 会开始下载并安装,安装完成后,窗口会提示 "Package 'requests' installed successfully",然后你就可以关闭这个窗口了。
    • 回到 Python Interpreter 设置页面,你会发现新安装的包已经出现在列表中了。

使用 PyCharm 内置的终端

这种方法与在系统的命令行(如 Windows 的 CMD 或 PowerShell,macOS/Linux 的 Terminal)中安装包完全一样,它更灵活,可以执行更复杂的命令。

步骤:

  1. 打开 PyCharm 的终端

    • 在 PyCharm 窗口的左下角,点击 Terminal 标签页,如果看不到,可以通过 View -> Tool Windows -> Terminal 来打开。
  2. 激活虚拟环境(非常重要!)

    • PyCharm 默认为每个项目创建一个独立的虚拟环境,在终端中,你会看到命令行提示符前有一个类似 (venv)(your_project_name) 的前缀,这表示虚拟环境已经激活了。
    • 如果看到 (venv),说明环境已激活,直接跳到第 3 步。
    • 如果没有看到 (venv),你需要手动激活它,激活命令取决于你的操作系统和 PyCharm 的配置:
      • Windows: .\venv\Scripts\activate
      • macOS/Linux: source venv/bin/activate
    • 激活后,你的终端提示符前就会出现 (venv)
  3. 使用 pip 安装包

    PyCharm如何安装Python模块?-图3
    (图片来源网络,侵删)
    • 在已激活虚拟环境的终端中,直接使用 pip 命令进行安装。
    • 基本安装: pip install 包名
      pip install requests
    • 安装指定版本: pip install 包名==版本号
      pip install numpy==1.21.0
    • requirements.txt 文件安装: 如果你有一个包含所有依赖项的 requirements.txt 文件,可以一次性安装所有包。
      pip install -r requirements.txt
    • 升级包: pip install --upgrade 包名
      pip install --upgrade pandas
    • 卸载包: pip uninstall 包名
      pip uninstall beautifulsoup4

重要概念:虚拟环境

在 PyCharm 中,每个项目默认都会创建一个虚拟环境,理解它至关重要:

  • 什么是虚拟环境? 它是一个与系统 Python 隔离的、独立的 Python 环境,在这个环境中,你可以安装任何包,而不会影响到你系统全局的 Python 环境或其他项目。
  • 为什么需要它?
    1. 避免版本冲突:项目 A 可能需要 numpy 1.20,而项目 B 需要 numpy 1.25,虚拟环境让它们可以各自拥有所需的版本,互不干扰。
    2. 保持项目整洁:所有项目相关的依赖都只存在于项目文件夹下的 venv 目录中,方便项目迁移和分享。
    3. 可复现性:通过 pip freeze > requirements.txt 命令,你可以将当前环境的所有包及其版本号导出到一个文件中,别人拿到这个文件后,可以用 pip install -r requirements.txt 完全复现你的环境。
  1. 优先使用图形界面:对于日常安装,使用 File -> Settings -> Python Interpreter -> 号是最简单、最不容易出错的方式。
  2. 善用终端:当你需要执行复杂的 pip 命令(如从 requirements.txt 安装、升级或卸载包)时,使用 PyCharm 内置的终端非常高效。
  3. 始终在虚拟环境中操作:确保你所有的安装操作都在项目的虚拟环境中进行,PyCharm 会默认帮你处理好这一点,你只需要留意终端提示符前的 (venv) 即可。
  4. 分享项目时带上 requirements.txt:当你需要将代码分享给他人时,记得将你的虚拟环境中的依赖导出为 requirements.txt 文件,一起分享。

常见问题排查

  • pip 不是内部或外部命令...`
    • 原因:系统的环境变量中没有正确添加 Python 的 Scripts 目录。
    • 解决:最简单的方法是始终在 PyCharm 的终端里使用 pip,因为 PyCharm 会自动配置好虚拟环境的路径,如果要在系统命令行使用,需要手动配置环境变量。
  • ModuleNotFoundError: No module named 'requests'
    • 原因:你在 A 环境中安装了 requests,但你的 PyCharm 项目正在使用 B 环境。
    • 解决:检查 Settings -> Python Interpreter,确保你选择的是正确的解释器(通常带有 (venv) 后缀的那个)。
  • 安装速度慢
    • 原因:默认的 PyPI 源在国外,访问可能较慢。
    • 解决:可以临时使用国内镜像源,在终端中安装时,使用 -i 参数:
      pip install -i https://pypi.tuna.tsinghua.edu.cn/simple some-package

      或者,你可以将这个镜像源设为默认,修改 pip 的配置文件(pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple)。

分享:
扫描分享到社交APP
上一篇
下一篇