PyCharm创建virtualenv环境时setuptools文件未找到RuntimeError问题

问题背景 #

• 此前使用PyCharm创建项目及virtualenv环境均正常，未进行相关更新操作
• 今日创建新项目并配置virtualenv环境时，出现setuptools相关RuntimeError，提示指定路径下文件不存在，但手动核查该路径确有对应文件
• 使用Python版本：3.10.9

报错日志（中文翻译版） #

回溯（最近的调用最后）：
  文件 "C:\Program Files\WindowsApps\PythonSoftwareFoundation.Python.3.10_3.10.2544.0_x64__qbz5n2kfra8p0\lib\runpy.py", 第196行, 在 _run_module_as_main中
    return _run_code(code, main_globals, None,
  文件 "C:\Program Files\WindowsApps\PythonSoftwareFoundation.Python.3.10_3.10.2544.0_x64__qbz5n2kfra8p0\lib\runpy.py", 第86行, 在 _run_code中
    exec(code, run_globals)
  文件 "C:\Program Files\JetBrains\PyCharm Community Edition 2022.3.1\plugins\python-ce\helpers\virtualenv-20.16.7.pyz\__main__.py", 第167行, 在 <module>中
  文件 "C:\Program Files\JetBrains\PyCharm Community Edition 2022.3.1\plugins\python-ce\helpers\virtualenv-20.16.7.pyz\__main__.py", 第163行, 在 run中
  文件 "C:\Program Files\JetBrains\PyCharm Community Edition 2022.3.1\plugins\python-ce\helpers\virtualenv-20.16.7.pyz\virtualenv\__main__.py", 第16行, 在 run中
  文件 "C:\Program Files\JetBrains\PyCharm Community Edition 2022.3.1\plugins\python-ce\helpers\virtualenv-20.16.7.pyz\virtualenv\run\__init__.py", 第30行, 在 cli_run中
  文件 "C:\Program Files\JetBrains\PyCharm Community Edition 2022.3.1\plugins\python-ce\helpers\virtualenv-20.16.7.pyz\virtualenv\run\session.py", 第43行, 在 run中
  文件 "C:\Program Files\JetBrains\PyCharm Community Edition 2022.3.1\plugins\python-ce\helpers\virtualenv-20.16.7.pyz\virtualenv\run\session.py", 第56行, 在 _seed中
  文件 "C:\Program Files\JetBrains\PyCharm Community Edition 2022.3.1\plugins\python-ce\helpers\virtualenv-20.16.7.pyz\virtualenv\seed\embed\via_app_data\via_app_data.py", 第69行, 在 run中
RuntimeError: 构建setuptools镜像失败，原因：
回溯（最近的调用最后）：
  文件 "C:\Program Files\JetBrains\PyCharm Community Edition 2022.3.1\plugins\python-ce\helpers\virtualenv-20.16.7.pyz\virtualenv\seed\embed\via_app_data\via_app_data.py", 第55行, 在 _install中
    installer.install(creator.interpreter.version_info)
  文件 "C:\Program Files\JetBrains\PyCharm Community Edition 2022.3.1\plugins\python-ce\helpers\virtualenv-20.16.7.pyz\virtualenv\seed\embed\via_app_data\pip_install\base.py", 第35行, 在 install中
    self._sync(filename, into)
  文件 "C:\Program Files\JetBrains\PyCharm Community Edition 2022.3.1\plugins\python-ce\helpers\virtualenv-20.16.7.pyz\virtualenv\seed\embed\via_app_data\pip_install\copy.py", 第11行, 在 _sync中
    copy(src, dst)
  文件 "C:\Program Files\JetBrains\PyCharm Community Edition 2022.3.1\plugins\python-ce\helpers\virtualenv-20.16.7.pyz\virtualenv\util\path\_sync.py", 第37行, 在 copy中
    method(str(src), str(dest))
  文件 "C:\Program Files\JetBrains\PyCharm Community Edition 2022.3.1\plugins\python-ce\helpers\virtualenv-20.16.7.pyz\virtualenv\util\path\_sync.py", 第48行, 在 copytree中
    shutil.copy(src_f, dest_f)
  文件 "C:\Program Files\WindowsApps\PythonSoftwareFoundation.Python.3.10_3.10.2544.0_x64__qbz5n2kfra8p0\lib\shutil.py", 第417行, 在 copy中
    copyfile(src, dst, follow_symlinks=follow_symlinks)
  文件 "C:\Program Files\WindowsApps\PythonSoftwareFoundation.Python.3.10_3.10.2544.0_x64__qbz5n2kfra8p0\lib\shutil.py", 第254行, 在 copyfile中
    with open(src, 'rb') as fsrc:
FileNotFoundError: [错误号 2] 没有该文件或目录: 'C:\\Users\\*username*\\AppData\\Local\\Packages\\PythonSoftwareFoundation.Python.3.10_qbz5n2kfra8p0\\LocalCache\\Local\\pypa\\virtualenv\\wheel\\3.10\\image\\1\\CopyPipInstall\\setuptools-65.5.1-py3-none-any\\setuptools\\config\\_validate_pyproject\\extra_validations.py'

解决方案 #

• 清理virtualenv缓存：删除报错路径中的virtualenv缓存目录（C:\Users\*username*\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.10_qbz5n2kfra8p0\LocalCache\Local\pypa\virtualenv），然后重新创建virtualenv环境
• 升级virtualenv版本：在系统Python环境中执行pip install --upgrade virtualenv，然后在PyCharm中配置使用系统安装的virtualenv，而非内置版本
• 更换Python安装包：当前使用的是Microsoft Store版本的Python，这类版本可能存在权限或路径兼容性问题，建议卸载后从Python官网下载安装标准版Python，勾选“Add Python to PATH”选项，再重新创建环境
• 手动创建virtualenv：跳过PyCharm图形界面配置，打开命令行进入项目目录，执行virtualenv venv（需确保virtualenv已安装），之后在PyCharm中选择该已创建的venv作为项目解释器

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