PyCharm新建/打开项目报错Invalid Python SDK 内置函数标红无法识别

背景 #

此前我使用PyCharm时Windows电脑发生严重崩溃，当时弹出了内存相关报错，随后直接硬崩溃无蓝屏，仅显示带细竖线的黑屏，重启后进入Windows安装/修复界面。自那以后我就遇到了该问题，网上找不到解决方法。

编辑：目前看来本次崩溃和该问题无关。

问题描述 #

我每次打开或新建PyCharm项目时，都会弹出Invalid Python SDK错误提示，具体内容如下： #

**Invalid Python SDK**
Cannot set up a Python SDK at Python 3.9 (%projectName%) (%projectPath%).The SDK seems to be invalid.

关闭报错后我的工作环境界面如下：工作环境截图。Project窗口中venv目录及其所有子目录都被标记为排除项（Exclusion），代码中print(f'Hi, {name}')等内置函数被标记为未解析引用错误，但程序可以正常运行。

另外我进入File -> Settings -> Project -> Python Interpreter界面时，底部会先出现黄色提示条显示：

Non-zero exit code (4)。

一段时间后提示变为：

Python packaging tools not found。

点击安装后无任何变化，且该界面的包添加“+”按钮处于灰化禁用状态：

我尝试查看Python解释器路径时，界面无任何路径显示：

总结：所有Python内置函数（如print）均被标记为错误，但实际运行正常，导致我无法区分真实报错和误报，严重影响编码效率。

已查询的相关问题 #

这类问题通常和解释器配置或路径有关，我已经尝试了同类问题下的多数解决方案，参考的问题包括：

• PyCharm shows unresolved references error for valid code
• 'Cannot setup a Python SDK' in PyCharm project using virtualenv after OS reinstallation
• Why do I get an 'SDK seems invalid' error when setting up my Project Interpreter in PyCharm?
• Invalid Python SDK Error while using python 3.4 on PyCharm
• Invalid Python SDK when setting a venv

原本打算附上链接，但我的Stack Overflow声望不足无法发布链接，以上问题均为Stack Overflow发布的内容，可直接通过谷歌搜索找到。

已尝试的解决方案 #

首先我已经尝试过完全卸载重装PyCharm、清除所有用户配置、卸载重装Python，分别从Python官网和PyCharm内置安装渠道安装Python，均无改善，其他尝试过的方案如下：

1. File -> Invalidate Caches... -> Invalidate and restart.，无效。
2. 在Edit Configurations中检查文件解释器，未发现异常，界面如下：
   
3. 刷新解释器路径，至今仍无路径显示：
   
4. 删除现有解释器后重新添加，无效。
5. 删除项目的.idea文件夹，无效。
6. 删除%homepath%/.PyCharm50路径下的PyCharm用户偏好设置，但我本地无该文件夹。
7. 来回切换不同解释器，无效。
8. 在其他路径新建解释器，无效。
9. 将项目根目录标记为源根：ProjectName -> Mark Directory as -> Sources Root，同时取消其他目录的排除标记，无效。
10. 不配置解释器：该方案虽然不再误报错误，但代码无法运行，不满足使用需求。
11. 检查venv/pyvenv.cfg的路径配置，确认配置正常：
    
12. 检查Windows环境变量的Path变量：原本Python路径仅在用户变量中，我已将其添加到系统变量，重启后仍无效。
13. 修改Windows账户名：我的用户文件夹原本为C:\Users\username，后续绑定微软账户后用户名变为带空格的User Name，无法修改，用户文件夹路径未变，不确定是否和该问题有关。

补充说明：我将Windows用户名从“username”改为带空格的“user name”是近期才操作的。

我已附上idea.log文件供排查，我将日志中的真实用户名替换为“User Name”以突出路径中存在空格的情况。

解决方案 #

该问题的核心诱因是Windows用户名含空格，导致PyCharm解析虚拟环境路径时出现异常，可按优先级选择以下方案修复：

1. 优先级最高：新建不含中文、空格的本地Windows账户，对应用户文件夹路径为C:\Users\XXX（XXX为纯英文无特殊字符名称），切换到该账户后重新安装Python和PyCharm，新建项目即可正常识别SDK。
2. 不想新建账户的替代方案：将所有Python开发相关内容移出用户目录，比如在D盘根目录新建Dev文件夹，Python安装到D:\Dev\Python\路径下，所有项目的虚拟环境统一创建到D:\Dev\venv\路径下，全程避免路径出现空格、中文或特殊字符。
3. 配置解释器时关闭自动扫描，手动指定python.exe路径：打开File -> Settings -> Project -> Python Interpreter，点击齿轮图标选择Add，在Virtualenv Environment下选择Existing environment，手动定位到虚拟环境目录下的Scripts\python.exe，勾选Make available to all projects后确认。
4. 完成上述操作后执行一次File -> Invalidate Caches... -> Invalidate and restart即可生效。

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