为何已成功安装customtkinter库却无法在VS Code中导入？

已成功安装customtkinter库，安装日志显示：

Using cached customtkinter-4.6.3-py3-none-any.whl (246 kB)
Requirement already satisfied: darkdetect in c:\users\omen1\appdata\local\programs\python\python311\lib\site-packages (from customtkinter) (0.7.1)
Installing collected packages: customtkinter
Successfully installed customtkinter-4.6.3

但在VS Code中运行import customtkinter时，出现错误：

Traceback (most recent call last):
  File "c:\Users\OMEN1\OneDrive\Skrivbord\python projects\database.py", line 290, in <module>
    import customtkinter
ModuleNotFoundError: No module named 'customtkinter'

已尝试卸载重装库、更新pip和Python3.11至最新版本，问题仍存在。

解决方案： #

• 检查VS Code使用的Python解释器

  1. 打开VS Code，按下Ctrl+Shift+P（Windows）/Cmd+Shift+P（Mac），输入Python: Select Interpreter。
  2. 选择路径为c:\users\omen1\appdata\local\programs\python\python311\python.exe的Python3.11解释器。
  3. 重新运行脚本。

• 确认pip与Python的对应关系

  1. 在终端运行python --version，确认当前终端使用的是Python3.11。
  2. 运行pip --version，检查pip所属路径是否指向c:\users\omen1\appdata\local\programs\python\python311\lib\site-packages\pip。
  3. 若路径不匹配，执行python -m pip install customtkinter，强制使用Python3.11的pip重新安装库。

• 排查虚拟环境（若使用）
  如果项目启用了虚拟环境，需先激活对应环境再安装customtkinter，或在VS Code中切换到虚拟环境的解释器。

• 手动添加库路径（终极方案）
  若以上方法无效，可在脚本开头添加代码手动指定库路径：

  import sys
  sys.path.append("c:\\users\\omen1\\appdata\\local\\programs\\python\\python311\\lib\\site-packages")
  import customtkinter
  

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