1**********************************************
2Windows 平台工具链的标准设置（传统 GNU Make）
3**********************************************
4:link_to_translation:`en:[English]`
5
6.. include:: ../gnu-make-legacy.rst
7
8概述
9====
10
11Windows 系统没有内置的 "make" 环境，所以除了安装工具链之外，您还需要一个兼容 GNU 的环境。这里，我们使用 MSYS2_ 环境兼容 GNU。您无需一直使用这个环境，比如您可以使用 :doc:`Eclipse <eclipse-setup>` 或其他前端，仅需在后台运行 MSYS2_ 即可。
12
13
14工具链设置
15==========
16
17最简便的工具链设置方法是从下方地址下载 Windows 多合一工具链和 MSYS2 压缩包文件：
18
19https://dl.espressif.com/dl/esp32_win32_msys2_environment_and_esp2020r2_toolchain-20200601.zip
20
21请将压缩包文件解压至 ``C:\``（或其他目录，但本文档中以 ``C:\`` 为例），该文件将为您创建一个带有预配置环境的 ``msys32`` 目录。
22
23
24开始尝试
25========
26
27请运行 ``C:\msys32\mingw32.exe`` 文件，打开一个 MSYS2 MINGW32 终端窗口。该窗口的环境为 bash shell。请创建一个名为 ``esp`` 的文件夹，作为 ESP32 应用程序开发的默认目录。您可以使用以下命令创建文件夹::
28
29    mkdir -p ~/esp
30
31您还可以通过 ``cd ~/esp`` 命令，进入刚刚创建的文件夹。如无其他问题，本步骤到此结束。
32
33.. figure:: ../../_static/msys2-terminal-window.png
34    :align: center
35    :alt: MSYS2 MINGW32 shell 窗口
36    :figclass: align-center
37
38    MSYS2 MINGW32 shell 窗口
39
40请在后续步骤中，使用本窗口配置 ESP32 的开发环境。
41
42
43后续步骤
44==========
45
46继续设置开发环境，请前往 :ref:`get-started-get-esp-idf-legacy` 章节。
47
48更新环境
49========
50
51当 IDF 有更新时，有时需要安装新的工具链或为 Windows MSYS2 环境添加新的要求。如需将旧版本预编译环境中的数据迁移至新版本，您可以：
52
531. 复制旧的 MSYS2 环境（即 ``C:\msys32``），并将其移动/重命名到不同目录下（即 ``C:\msys32_old``）。
542. 使用上述步骤，下载新的预编译环境。
553. 将新的 MSYS2 环境解压缩至 ``C:\msys32`` （或您指定的其他位置）。
564. 找到旧的 ``C:\msys32_old\home`` 文件夹，并将其移动至 ``C:\msys32``。
575. 此时，如无其他需要，您可以删除旧的 ``C:\msys32_old\home`` 文件夹。
58
59注意，您可以在电脑中安装多个不同的 MSYS2 环境，仅需将它们保存在不同的路径下即可。
60
61此外，您还可以 :ref:`直接更新现有环境（无需下载新的版本）<updating-existing-windows-environment-legacy>`，但步骤更加复杂。
62
63相关文档
64========
65
66.. toctree::
67    :maxdepth: 1
68
69    windows-setup-scratch
70
71
72.. _MSYS2: https://www.msys2.org/
73
74