【wxPython 安装指南：error: legacy

# 安装环境

## 安装xwPython

### 问题

当前使用的python环境为python 3.10.2[wxPython 4.1.1目前最高版本支持仅到Python 3.9](https://discuss.wxpython.org/t/wxpython-for-python-3-10-1-windows-64bit/35745)，因此在安装时会出现如下问题, 主要是：

note: This error originates from a subprocess, and is likely not a problem with pip.

error: legacy-install-failure

References:

[1] https://discuss.wxpython.org/t/wxpython-for-python-3-10-1-windows-64bit/35745

[2] https://wxpython.org/Phoenix/snapshot-builds/

[3] https://extras.wxpython.org/wxPython4/extras/4.1.1/

```

>pip3 install -U wxPython

Collecting wxPython

  Using cached wxPython-4.1.1.tar.gz (66.0 MB)

  Preparing metadata (setup.py) ... done

Requirement already satisfied: pillow in c:\customprogram\python310\lib\site-packages (from wxPython) (9.1.0)

Requirement already satisfied: six in c:\customprogram\python310\lib\site-packages (from wxPython) (1.16.0)

Requirement already satisfied: numpy in c:\customprogram\python310\lib\site-packages (from wxPython) (1.22.3)

Building wheels for collected packages: wxPython

  Building wheel for wxPython (setup.py) ... error

  error: subprocess-exited-with-error

  × python setup.py bdist_wheel did not run successfully.

  │ exit code: 1

  ╰─> [51 lines of output]

      C:\CustomProgram\Python310\lib\site-packages\setuptools\dist.py:717: UserWarning: Usage of dash-separated 'license-file' will not be supported in future versions. Please use the underscore name 'license_file' instead

        warnings.warn(

      C:\CustomProgram\Python310\lib\site-packages\setuptools\dist.py:294: DistDeprecationWarning: use_2to3 is ignored.

        warnings.warn(f"{attr} is ignored.", DistDeprecationWarning)

      running bdist_wheel

      running build

      C:\Users\*****\AppData\Local\Temp\pip-install-orv4glt0\wxpython_dcdb3ca6e5ae4a3fb1044710386c6da5\build.py:41: DeprecationWarning: The distutils package is deprecated and slated for removal in Python 3.12. Use setuptools or check PEP 632 for potential alternatives

        from distutils.dep_util import newer, newer_group

      Will build using: "C:\CustomProgram\Python310\python.exe"

      3.10.2 (tags/v3.10.2:a58ebcc, Jan 17 2022, 14:12:15) [MSC v.1929 64 bit (AMD64)]

      Python's architecture is 64bit

      cfg.VERSION: 4.1.1

      Running command: build

      Running command: build_wx

      Command '"C:\CustomProgram\Python310\python.exe" -c "import setuptools, distutils.msvc9compiler as msvc; mc = msvc.MSVCCompiler(); mc.initialize(); print(mc.cc)"' failed with exit code 1.

      Traceback (most recent call last):

        File "", line 1, in

        File "C:\CustomProgram\Python310\lib\distutils\msvc9compiler.py", line 371, in initialize

          vc_env = query_vcvarsall(VERSION, plat_spec)

        File "C:\CustomProgram\Python310\lib\site-packages\setuptools\msvc.py", line 140, in msvc9_query_vcvarsall

          return EnvironmentInfo(arch, ver).return_env()

        File "C:\CustomProgram\Python310\lib\site-packages\setuptools\msvc.py", line 1740, in return_env

          [self.VCIncludes,

        File "C:\CustomProgram\Python310\lib\site-packages\setuptools\msvc.py", line 1282, in VCIncludes

          return [join(self.si.VCInstallDir, 'Include'),

        File "C:\CustomProgram\Python310\lib\site-packages\setuptools\msvc.py", line 840, in VCInstallDir

          raise distutils.errors.DistutilsPlatformError(msg)

      distutils.errors.DistutilsPlatformError: Microsoft Visual C++ 14.2 or greater is required. Get it with "Microsoft C++ Build Tools": https://visualstudio.microsoft.com/visual-cpp-build-tools/

      Finished command: build_wx (0.293s)

      Finished command: build (0.293s)

      WARNING: Building this way assumes that all generated files have been

      generated already.  If that is not the case then use build.py directly

      to generate the source and perform the build stage.  You can use

      --skip-build with the bdist_* or install commands to avoid this

      message and the wxWidgets and Phoenix build steps in the future.

      "C:\CustomProgram\Python310\python.exe" -u build.py build

      Command '"C:\CustomProgram\Python310\python.exe" -u build.py build' failed with exit code 1.

      [end of output]

  note: This error originates from a subprocess, and is likely not a problem with pip.

  ERROR: Failed building wheel for wxPython

  Running setup.py clean for wxPython

Failed to build wxPython

Installing collected packages: wxPython

  Running setup.py install for wxPython ... error

  error: subprocess-exited-with-error

  × Running setup.py install for wxPython did not run successfully.

  │ exit code: 1

  ╰─> [51 lines of output]

      C:\CustomProgram\Python310\lib\site-packages\setuptools\dist.py:717: UserWarning: Usage of dash-separated 'license-file' will not be supported in future versions. Please use the underscore name 'license_file' instead

        warnings.warn(

      C:\CustomProgram\Python310\lib\site-packages\setuptools\dist.py:294: DistDeprecationWarning: use_2to3 is ignored.

        warnings.warn(f"{attr} is ignored.", DistDeprecationWarning)

      running install

      running build

      C:\Users\*****\AppData\Local\Temp\pip-install-orv4glt0\wxpython_dcdb3ca6e5ae4a3fb1044710386c6da5\build.py:41: DeprecationWarning: The distutils package is deprecated and slated for removal in Python 3.12. Use setuptools or check PEP 632 for potential alternatives

        from distutils.dep_util import newer, newer_group

      Will build using: "C:\CustomProgram\Python310\python.exe"

      3.10.2 (tags/v3.10.2:a58ebcc, Jan 17 2022, 14:12:15) [MSC v.1929 64 bit (AMD64)]

      Python's architecture is 64bit

      cfg.VERSION: 4.1.1

      Running command: build

      Running command: build_wx

      Command '"C:\CustomProgram\Python310\python.exe" -c "import setuptools, distutils.msvc9compiler as msvc; mc = msvc.MSVCCompiler(); mc.initialize(); print(mc.cc)"' failed with exit code 1.

      Traceback (most recent call last):

        File "", line 1, in

        File "C:\CustomProgram\Python310\lib\distutils\msvc9compiler.py", line 371, in initialize

          vc_env = query_vcvarsall(VERSION, plat_spec)

        File "C:\CustomProgram\Python310\lib\site-packages\setuptools\msvc.py", line 140, in msvc9_query_vcvarsall

          return EnvironmentInfo(arch, ver).return_env()

        File "C:\CustomProgram\Python310\lib\site-packages\setuptools\msvc.py", line 1740, in return_env

          [self.VCIncludes,

        File "C:\CustomProgram\Python310\lib\site-packages\setuptools\msvc.py", line 1282, in VCIncludes

          return [join(self.si.VCInstallDir, 'Include'),

        File "C:\CustomProgram\Python310\lib\site-packages\setuptools\msvc.py", line 840, in VCInstallDir

          raise distutils.errors.DistutilsPlatformError(msg)

      distutils.errors.DistutilsPlatformError: Microsoft Visual C++ 14.2 or greater is required. Get it with "Microsoft C++ Build Tools": https://visualstudio.microsoft.com/visual-cpp-build-tools/

      Finished command: build_wx (0.254s)

      Finished command: build (0.254s)

      WARNING: Building this way assumes that all generated files have been

      generated already.  If that is not the case then use build.py directly

      to generate the source and perform the build stage.  You can use

      --skip-build with the bdist_* or install commands to avoid this

      message and the wxWidgets and Phoenix build steps in the future.

      "C:\CustomProgram\Python310\python.exe" -u build.py build

      Command '"C:\CustomProgram\Python310\python.exe" -u build.py build' failed with exit code 1.

      [end of output]

  note: This error originates from a subprocess, and is likely not a problem with pip.

error: legacy-install-failure

× Encountered error while trying to install package.

╰─> wxPython

note: This is an issue with the package mentioned above, not pip.

hint: See above for output from the failure.

```

### 解决办法：

1. 降级Python 3到python 3.9或更低

2. 安装wxPython310

```

pip3 install wxpython310

```