使用Customtkinter遇“No module named customtkinter”问题的解决方法

问题重现 #

代码示例：

import customtkinter
janela = customtkinter.Ctk()
janela.geomtrey("500x600")  # 存在拼写错误

遇到的问题：

• 运行提示No module named 'customtkinter'，已执行pip install customtkinter但无效
• IDE中customtkinter下方出现黄色下划线

解决步骤 #

1. 确保pip与Python环境匹配 #

多数情况是pip对应了不同的Python版本，尝试以下命令重新安装：

• 针对Python3：pip3 install customtkinter
• 强制使用当前Python解释器的pip：python -m pip install customtkinter
• 若使用虚拟环境，先激活虚拟环境再执行安装命令

2. 验证安装是否成功 #

打开终端执行以下命令，能输出版本号则说明安装有效：

python -c "import customtkinter; print(customtkinter.__version__)"

3. 配置IDE的Python解释器 #

黄色下划线一般是IDE未找到对应包，以VS Code为例：

• 按下Ctrl+Shift+P（Windows）/Cmd+Shift+P（Mac），输入Python: Select Interpreter
• 选择你用来安装customtkinter的那个Python解释器（比如带虚拟环境标识、对应版本的Python）

4. 修正代码拼写错误 #

代码里的geomtrey是拼写错误，需改成geometry，否则运行会报错：

janela.geometry("500x600")

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