ModuleNotFoundError：Python 中没有名为“serial”的模块

作者

ModuleNotFoundError：Python 中没有名为“serial”的模块

ModuleNotFoundError: No module named ‘serial’ in Python

Python “ModuleNotFoundError: No module named ‘serial’” 出现在我们忘记pyserial在导入前安装模块或将其安装在不正确的环境中时。

要解决此错误，请通过运行命令安装模块pip install pyserial
。

没有名为 serial 的模块

在项目的根目录中打开终端并安装pyserial
模块。

壳
# 👇️ in a virtual environment or using Python 2
pip install pyserial

# 👇️ for python 3 (could also be pip3.10 depending on your version)
pip3 install pyserial

# 👇️ if you get permissions error
sudo pip3 install pyserial
pip install pyserial --user

# 👇️ if you don't have pip in your PATH environment variable
python -m pip install pyserial

# 👇️ for python 3 (could also be pip3.10 depending on your version)
python3 -m pip install pyserial

# 👇️ using py alias (Windows)
py -m pip install pyserial

# 👇️ for Anaconda
conda install -c anaconda pyserial

# 👇️ for Jupyter Notebook
!pip install pyserial

安装pyserial包后，尝试按如下方式导入它。

主程序
import serial

print(serial.__version__)

出现错误的原因有多种：

  1. 没有pyserial通过运行安装包
    pip install pyserial。
  2. 在与您正在使用的版本不同的 Python 版本中安装包。
  3. 全局安装包，而不是在您的虚拟环境中。
  4. 您的 IDE 运行的 Python 版本不正确。
  5. 命名您的模块serial.py，这将影响官方模块。
  6. 声明一个名为serialwhich 的变量将隐藏导入的变量。

如果错误仍然存​​在，请获取您的 Python 版本并确保您使用正确的 Python 版本安装包。

壳
python --version

获取 python 版本

例如，我的 Python 版本是3.10.4，所以我会安装 pyserial 包pip3.10 install pyserial。

壳
pip3.10 install pyserial

# 👇️ if you get permissions error use pip3 (NOT pip3.X)
sudo pip3 install pyserial

请注意，版本号对应于我正在使用的版本pip。

pip如果您的计算机上未设置PATH ，请替换pip为
python3 -m pip：

壳
# 👇️ make sure to use your version of Python, e.g. 3.10
python3 -m pip install pyserial

如果错误仍然存​​在，请尝试重新启动您的 IDE 和开发服务器/脚本。

检查包是否安装

您可以

通过运行命令检查是否pyserial安装了软件包pip show pyserial。

壳
# 👇️ check if you have pyserial installed
pip show pyserial

# 👇️ if you don't have pip set up in PATH
python -m pip show pyserial

该pip show pyserial命令将声明该包未安装或显示有关该包的一堆信息，包括该包的安装位置。

确保你的 IDE 使用正确的 Python 版本

如果未安装该包，请确保您的 IDE
使用的是正确版本的 Python。

如果您的机器上安装了多个 Python 版本，您可能使用了不正确的版本安装了pyserial包，或者您的 IDE 可能被设置为使用不同的版本。

例如，在 VSCode 中，您可以按CTRL + Shift + P或（在 Mac 上为⌘+ Shift+ P
）打开命令面板。

然后在字段中键入“Python 选择解释器”。

python选择解释器

然后从下拉菜单中选择正确的 python 版本。

选择正确的python版本

您的 IDE 应该使用与您用于从终端安装包的相同版本的 Python（包括虚拟环境）。

在虚拟环境中安装包

如果您使用的是虚拟环境，请确保您是pyserial
在虚拟环境中而不是全局安装。

如果您还没有虚拟环境，可以尝试创建一个。

壳
# 👇️ use correct version of Python when creating VENV
python3 -m venv venv

# 👇️ activate on Unix or MacOS
source venv/bin/activate

# 👇️ activate on Windows (cmd.exe)
venv\Scripts\activate.bat

# 👇️ activate on Windows (PowerShell)
venv\Scripts\Activate.ps1

# 👇️ install pyserial in virtual environment
pip install pyserial

如果该python3 -m venv venv命令不起作用，请尝试以下 2 个命令：

  • python -m venv venv
  • py -m venv venv

您的虚拟环境将使用用于创建它的 Python 版本。

如果错误仍然存​​在，请确保您没有在项目中命名模块，因为那样会影响原始模块。 serial.py pyserial

您也不应该声明一个名为serialas 的变量，这也会影响原始模块。

尝试重新安装包

如果错误未解决，请尝试卸载该pyserial软件包，然后
重新安装。

壳
# 👇️ check if you have pyserial installed
pip show pyserial

# 👇️ if you don't have pip set up in PATH
python -m pip show pyserial

# 👇️ uninstall pyserial
pip uninstall pyserial

# 👇️ if you don't have pip set up in PATH
python -m pip uninstall pyserial

# 👇️ install pyserial
pip install pyserial

# 👇️ if you don't have pip set up in PATH
python -m pip install pyserial

尝试重新启动您的 IDE 和开发服务器/脚本。

也可以尝试升级pyserial包的版本。

壳
pip install pyserial --upgrade

# 👇️ if you don't have pip set up in PATH
python -m pip install pyserial --upgrade
如果错误仍然存​​在，请按照有关如何安装pyserial.

目录

  1. 在 Windows 上安装 pyserial
  2. 在 macOS 或 Linux 上安装 pyserial
  3. 在 Visual Studio Code 中安装 pyserial
  4. 在 PyCharm 中安装 pyserial
  5. 在 Anaconda 中安装 pyserial
  6. 在 Jupyter Notebook 中安装 pyserial

在 Windows 上安装 pyserial

pyserial在 Windows 上安装模块：

  1. 在搜索栏中键入 CMD，然后打开命令提示符应用程序。
  2. 键入pip install pyserial并按 Enter。
命令
pip install pyserial

# 👇️ for Python 3
pip3 install pyserial

# 👇️ if you don't have pip in your PATH environment variable
python -m pip install pyserial

# 👇️ for Python 3
python3 -m pip install pyserial

# 👇️ using py alias
py -m pip install pyserial

# 👇️ if you get permissions error
pip install pyserial --user

# 👇️ for Anaconda
conda install -c anaconda pyserial

pip 安装 pyserial 窗口

如果命令不成功，请尝试以管理员身份运行 CMD。

右键单击搜索结果，单击“以管理员身份运行”并运行 pip install 命令。

以管理员身份运行cmd

如果你收到错误
‘pip’ is not recognized as an internal or external command，python -m安装时使用命令pyserial。

壳
python -m pip install pyserial

python3 -m pip install pyserial

py -m pip install pyserial

pyserial或者，您可以在虚拟环境中安装该模块：

  1. 打开项目的根目录。
  2. 在资源管理器中按下Shift并右键单击。

windows 在此处打开 powershell 窗口

  1. 单击“在此处打开 PowerShell 窗口”。
  2. 运行以下命令。
电源外壳
# 👇️ might also be: "python3 -m venv venv"
python -m venv venv

# 👇️ activate on Windows (PowerShell)
venv\Scripts\Activate.ps1

# 👇️ activate on Windows (cmd.exe)
venv\Scripts\activate.bat

# 👇️ install pyserial in virtual environment
pip install pyserial

如果该python -m venv venv命令不起作用，请尝试以下 2 个命令：

  • python3 -m venv venv
  • py -m venv venv.

如果您看到无法加载 ps1 的错误消息
，因为在此系统上禁用了运行脚本，请运行以下命令，在出现提示时键入“yes”并重新运行激活命令。

电源外壳
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
您可以pyserial使用命令验证模块是否已安装。 pip show pyserial
电源外壳
pip show pyserial
pip3 show pyserial

python -m pip show pyserial
python3 -m pip show pyserial

该pip show pyserial命令将声明该包未安装或显示有关该包的一堆信息，包括该包的安装位置。

在 macOS 或 Linux 上安装 pyserial

要在 macOS 或 Linux 上安装 pyserial：

  1. 搜索“终端”并启动应用程序。
  2. 键入pip install pyserial并按 Enter。

搜索终端

终端
pip install pyserial

# 👇️ for Python 3
pip3 install pyserial

# 👇️ if you get permissions error
sudo pip3 install pyserial

# 👇️ if you don't have pip in your PATH environment variable
python -m pip install pyserial

# 👇️ for python 3
python3 -m pip install pyserial

# 👇️ alternative if you get permissions error
pip install pyserial --user

# 👇️ for Anaconda
conda install -c anaconda pyserial

macos linux 安装 pyserial

如果您收到未发现的错误pip，请使用该python -m命令。

终端
python -m pip install pyserial

python3 -m pip install pyserial

如果出现权限错误，请在命令前加上sudo.

终端
sudo pip install pyserial

sudo pip3 install pyserial

或者，您可以pyserial在虚拟环境中安装该软件包：

  1. 在项目的根目录中打开终端。
  2. 运行以下命令。
壳
# 👇️ could also be "python -m venv venv"
python3 -m venv venv

# 👇️ activate virtual env on macOS or Linux
source venv/bin/activate

# 👇️ install pyserial in virtual environment
pip install pyserial

您的虚拟环境将使用用于创建它的 Python 版本。

如果该python3 -m venv venv命令不起作用，请改用。 python -m venv venv

您可以使用该pip show命令来验证
pyserial是否已
成功安装。

壳
pip show pyserial
pip3 show pyserial

python -m pip show pyserial
python3 -m pip show pyserial

该pip show pyserial命令将声明该包未安装或显示有关该包的一堆信息。

在 Visual Studio Code 中安装 pyserial

在 Visual Studio Code 中安装 pyserial：

  1. 按键盘上的 CTRL + ` （反引号）打开终端。
  2. 运行pip install pyserial命令以安装pyserial模块。
终端
pip install pyserial

# 👇️ for Python 3
pip3 install pyserial

# 👇️ if you get permissions error
sudo pip3 install pyserial

# 👇️ if you don't have pip in your PATH environment variable
python -m pip install pyserial

# 👇️ for python 3
python3 -m pip install pyserial

# 👇️ using py alias
py -m pip install pyserial

# 👇️ alternative if you get permissions error
pip install pyserial --user

vscode pip 安装 pyserial

您还可以在 Visual Studio Code 中打开终端，方法是按下然后键入“View: Toggle Terminal”。 CTRL+Shift+P

在 Visual Studio 代码中安装 Python 模块时，请确保
您的 IDE 配置为使用正确的 Python 版本。

按CTRL+Shift+P或（在 Mac 上为⌘+ Shift+ P）打开命令面板。

然后在字段中键入“Python 选择解释器”。

python选择解释器

然后从下拉菜单中选择正确的 Python 版本。

选择正确的python版本

您的 IDE 应该使用与您用于从终端安装包的相同版本的 Python（包括虚拟环境）。

python --version如果您需要获取您的 Python 版本，可以使用该命令。

终端
python --version
python3 --version

获取 python 版本

如果您还没有虚拟环境，也可以尝试创建一个。

终端
# 👇️ could also be "python -m venv venv" or "py -m venv venv"
python3 -m venv venv

# 👇️ activate on Unix or MacOS
source venv/bin/activate

# 👇️ activate on Windows (cmd.exe)
venv\Scripts\activate.bat

# 👇️ activate on Windows (PowerShell)
venv\Scripts\Activate.ps1

# 👇️ install pyserial in virtual environment
pip install pyserial

您的虚拟环境将使用用于创建它的 Python 版本。

在 PyCharm 中安装 pyserial

在 PyCharm 中安装 pyserial：

  1. 按Alt+F12键盘打开终端。
  2. 运行pip install pyserial命令以安装pyserial模块。
终端
pip install pyserial

# 👇️ for Python 3
pip3 install pyserial

# 👇️ if you get permissions error
sudo pip3 install pyserial

# 👇️ if you don't have pip in your PATH environment variable
python -m pip install pyserial

# 👇️ for python 3
python3 -m pip install pyserial

# 👇️ using py alias
py -m pip install pyserial

# 👇️ alternative if you get permissions error
pip install pyserial --user

pycharm pip 安装 pyserial

或者，您可以使用 IDE 本身来安装模块。

  1. 单击“文件”>“设置”>“项目”>“Python 解释器”。
  2. 单击+图标并键入pyserial。
  3. 单击“安装包”。

pycharm解释器安装pyserial

在 PyCharm 中安装 Python 模块时，请确保您的 IDE 配置为使用正确版本的 Python。

单击“文件”>“设置”>“项目”>“Python 解释器”。

pycharm 选择正确的解释器

然后从下拉菜单中选择正确的 Python 版本。

您的 IDE 应该使用与您用于从终端安装包的相同版本的 Python（包括虚拟环境）。

python --version如果您需要获取您的 Python 版本，可以使用该命令。

终端
python --version
python3 --version

获取 python 版本

在 Anaconda 中安装 pyserial

在 Anaconda 中安装 pyserial：

  1. 打开您的 Anaconda 导航器。
  2. 单击“环境”并选择您的项目。
  3. pyserial在右侧的搜索栏中输入。
  4. 勾选pyserial包并单击“应用”。

anaconda navigator 安装包

或者，您可以pyserial使用命令安装包。

如果您使用的是 Windows，请搜索“Anaconda Prompt”并打开该应用程序。

如果您使用的是 macOS 或 Linux，请打开您的终端。

运行以下命令来安装pyserial包。

壳
# 👇️ using conda
conda install -c anaconda pyserial

# 👇️ Alternatively use `pip`
pip install pyserial

# 👇️ for Python 3
pip3 install pyserial

# 👇️ if you get permissions error
sudo pip3 install pyserial

# 👇️ if you don't have pip in your PATH environment variable
python -m pip install pyserial

# 👇️ for python 3
python3 -m pip install pyserial

# 👇️ using py alias
py -m pip install pyserial

# 👇️ alternative if you get permissions error
pip install pyserial --user


如果您需要使用 Anaconda 安装特定版本的软件包，请单击
以下文章。

在 Jupyter Notebook 中安装 pyserial

在 Jupyter Notebook 中安装 pyserial：

  1. 打开您的终端并输入“jupyter notebook”。

打开 jupyter 笔记本

  1. 单击浏览器选项卡中的“新建”，然后单击“终端”。

jupyter notebook 点击新建终端

  1. 键入pip install pyserial并按 Enter。
壳
# 👇️ using pip
pip install pyserial

# 👇️ for Python 3
pip3 install pyserial

# 👇️ if you get permissions error
sudo pip3 install pyserial

# 👇️ if you don't have pip in your PATH environment variable
python -m pip install pyserial

# 👇️ for python 3
python3 -m pip install pyserial

# 👇️ using py alias
py -m pip install pyserial

# 👇️ using conda
conda install -c anaconda pyserial

# 👇️ alternative if you get permissions error
pip install pyserial --user

或者，您可以使用 Python ipykernel。

  1. 打开您的终端并输入“jupyter notebook”。

打开 jupyter 笔记本

  1. 单击“新建”，然后单击“Python 3 (ipykernel)”。
    jupyter notebook 点击新的 ipykernel

  2. 键入!pip install pyserial并单击“运行”。

jupyter notebook 安装模块

请注意，pip install如果您使用此方法，该命令必须以感叹号为前缀。

壳
!pip install pyserial

键入命令后，单击“运行”以安装模块pyserial。

如果出现权限错误，例如“ [WinError: 5] Access is denied”，请将
--user选项添加到安装命令中。

壳
!pip install pyserial --user

使用用户选项安装 jupyter notebook

如果错误仍然存​​在，请尝试
重新启动 Jupyter 内核
并重新运行该命令。