pynput在代码中显示警告，运行时提示ModuleNotFoundError如何解决

Traceback (most recent call last):
File "C:\Users\encur\Python\os.py", line 5, in
from pynput.keyboard import Key, Controller
ModuleNotFoundError: No module named 'pynput'

• 直接报错原因：运行代码时调用的Python环境中没有安装pynput库。编辑阶段仅显示警告、不直接标红报错，是因为编辑器配置的Python解释器和实际运行代码用的解释器不匹配——编辑器索引到了其他安装过pynput的Python环境，所以只给出弱警告，但运行时加载的是未安装该库的环境，直接触发导入错误。
• 隐藏冲突风险：当前代码文件命名为os.py，和Python内置标准库的os模块完全重名，就算解决了pynput的安装问题，后续代码调用os模块相关功能时也会出现导入混乱，触发更难排查的错误。

• 锁定运行时实际使用的Python解释器
  打开运行代码所用的终端，Windows系统执行where python，macOS/Linux系统执行which python，记录返回的Python可执行文件完整路径。如果使用虚拟环境，先确认虚拟环境处于激活状态（激活成功后终端输入行开头会显示虚拟环境名称）。
• 针对目标解释器安装pynput
  不要随意在无关终端窗口执行pip安装命令，必须针对上一步查到的解释器执行安装，最稳妥的方式是调用解释器本身的pip模块，命令格式如下：

  <查到的Python可执行文件完整路径> -m pip install pynput
  

  如果使用PyCharm、VS Code等带内置终端的编辑器，直接在编辑器底部调出的内置终端执行pip install pynput即可，内置终端默认会自动加载当前项目配置的解释器环境，不会装错位置。
• 对齐编辑器解释器配置
  安装完成后，在编辑器的Python解释器选择面板中，选中刚刚安装了pynput的Python环境，保证编辑阶段的依赖检查、代码补全，和运行阶段的代码执行使用完全相同的环境，从根源上避免编辑提示和运行结果错位的问题。
• 修复文件名冲突
  立刻将当前命名为os.py的代码文件重命名为其他不与Python标准库重名的名称，比如和功能匹配的pynput_test.py，同时删除同目录下__pycache__文件夹内的相关缓存文件，避免后续出现模块导入冲突。

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