pip安装pyserial后无法导入serial模块的问题该如何解决？

• Python环境不匹配：pip对应的Python解释器，和代码运行时调用的解释器、编辑器Pylance绑定的解释器不属于同一个环境，导致安装的包无法被识别。
• 包名冲突：PyPI上存在一个名为serial的废弃第三方包，与pyserial的导入名冲突，如果此前误装了serial包，会覆盖pyserial的导入路径。
• Pylance解释器配置错误：编辑器没有指定到安装了pyserial的Python环境，就算运行环境正确，Pylance也会误报依赖缺失。
• 安装异常：pip安装过程中因为权限不足、网络中断等问题导致pyserial未完成安装，或安装路径不在当前Python的包搜索路径中。

• 确认环境一致性后重新安装：不要直接使用无后缀的pip命令，使用你运行代码对应的Python解释器直接调用pip安装，比如你运行代码用的是python3 xxx.py，就执行以下命令：

  # 先检查该环境下是否已安装pyserial
  python3 -m pip show pyserial
  # 若无输出则执行安装
  python3 -m pip install pyserial
  

  如果你使用虚拟环境，需先激活对应虚拟环境再执行上述命令。
• 解决包名冲突：先卸载冲突的包再重新安装pyserial，执行命令：

  pip uninstall serial pyserial -y
  pip install pyserial
  

• 配置Pylance绑定的解释器（以VS Code为例）：按下Ctrl+Shift+P（Mac系统为Cmd+Shift+P），搜索并选择Python: Select Interpreter，在列表中选中已经安装pyserial的对应Python环境，等待Pylance重新索引完成后报错就会消失。
• 处理权限类安装问题：Linux/macOS普通用户安装时可添加--user参数避免权限不足：

  python3 -m pip install pyserial --user
  

  Windows用户可使用管理员身份启动终端后再执行安装命令。

内容的提问来源于stack exchange，提问作者CrippleyDippley