系统需求:
Win7/Win8/Win10/Win11
32/64位CPU
20MB以上磁盘空间
关于软件授权期限的说明:
目前软件并不收费。但作者无力维护旧版本，为促使用户更新软件(同时也促使作者自己积极更新)，每个版本会内置数个月的授权限制。
此限制不影响功能使用。授权过期后将无法离网(联网检查更新后会获得新的临时授权)使用。
建议更新到新版本以避免此限制。
第三方软件:
如果要使用工程管理，编译，调试，自动补全等功能时，根据具体情况需要用到不同的第三方的软件工具。
编译调试msvc生成的程序需要用到VisualStudio的编译器。（调试器使用操作系统内建的dbgeng，也可以由用户手动从WinDBG中提取）
编译调试gcc生成的程序需要用到gcc的Windows版本，如：msys2/mingw32/mingw-w64。GDB的Windows版本。
编译调试llvm-msvc版本(即llvm官方windows版本)生成的应用需要依赖Windows SDK（VisualStudio中已经包含）。
编译调试llvm-mingw版本生成的应用需要依赖mingw32运行库以及gdb。
编译调试WSL应用时，您需要准备WSL环境，并在环境内安装gcc,gdb,cmake,ninja-build工具。
CMake工程需要用到CMake及Ninja-Build工具。
C/C++语法补全需要用到clangd。（llvm-msvc官方发行的Windows版本中包含，msys2中的版本不稳定经常崩溃）
Intel OneAPI
官方网站
虽然intel的编译器在大多数场景下并没有太大优势，但其中的VTune等工具对于性能优化有非常大的帮助
EDX + GCC v14.2 + Binutils 2.44 + GDB v16.2 + CMake v3.31.3 +
Ninja-Build v1.12.1 + clangd v19.1.7
整合包(83MB)
更新时间: 2025-02-06
此包中gcc,binutils,gdb/clangd为私有编译版本。Ninja-Build，CMake由官方发行版中提取。
其中：
gcc整合了msys中gcc14.2的所有补丁。整合了mingw-w64-i686及mingw-w64-x86_64 v11.0.1运行时库，可以生成32/64位Windows桌面应用。
binutils包含了优化过的BFD库，大幅优化了处理PE COFF目标的性能(相比lld仍慢一些，但已经没有替换为lld的必要了)。
EDX + LLVM-Mingw 19.1.7(包含clangd) + GDB v16.2 + CMake v3.31.3 + Ninja-Build v1.12.1
整合包(82MB)
更新时间: 2025-02-06
此包中LLVM-Mingw为官方版本精简了arm/arm64相关工具。gdb为私有编译版本。Ninja-Build，CMake由官方发行版中提取。
clang编译速度较gcc快很多，只比msvc慢少许。
EDX + AirMCU/STM32Cube/GD32/XHSC SDK + arm-gcc-13.2.1 + GDB v14.2 + CMake v3.29.5 +
Ninja-Build v1.12.1 + clangd v18.1.1 + openocd 0.12.0 + pyocd 0.36.0
整合包(131MB)
更新时间: 2024-05-17
此包中arm-gcc为官方精简版本。gdb/clangd为私有编译版本。
AirMCU/STM32Cube/GD32/XHSC SDK, Ninja-Build，CMake，openocd，pyocd 由官方发行版中提取。
支持STM32/GD32/HC32F460/Air001/Air32F103系列MCU。其中AirMCU SDK还支持Arduino模式。
EDX + Pico C-SDK + arm-gcc-13.2.1 + mingw64-gcc v13.2 + GDB v14.2 + CMake v3.29.5 +
Ninja-Build v1.12.1 + clangd v18.1.1 + openocd 0.12.0
整合包(150MB)
更新时间: 2024-05-17
此包中arm-gcc为官方精简版本，mingw64-gcc/gdb/clangd为私有编译版本。
Pico C-SDK, Ninja-Build，CMake，openocd 由官方发行版中提取。
包含mingw64-gcc是为了编译pico工具程序。
以下为mingw拆分组件，包含binutils,mingw-crt,gcc,gdb的不同版本独立包，可任意组合使用。
更新时间: 2025-02-06
任意的bintuils + crt + gcc可组成一套完整的工具链。
Binutils优化版使用了我优化的bfd库，大幅提升了ld/ar/ranlib/strip/objcopy/objdump等工具的性能。其中链接大型调试版本应用时，性能提升了约100倍。
(v2.41版官方引入了针对COFF格式的优化补丁，与我优化的方案类似，但性能要差一些(最多差1个数量级)。我这里还原了官方的优化补丁，改为我的实现。)
(v2.44版官方进一步优化了PE中关于COMDAT的相关逻辑，整体上与我优化的2.41版性能接近。此优化版本整合了部分我的优化逻辑，性能较官方版本高2%~10%)
GCC5~9的编译速度明显要好于GCC10~13。但对语言标准支持会差一些。使用C++20相关特性，请使用GCC10以上版本。
GCC12/13包含了MSYS2中相应的补丁，如：改进支持预编译头等。
GCC的SEH、SJLJ版本差别在于C++异常的实现方式不同，存在一定的性能和兼容性差异。在同一系统中请使用相同的异常实现方案。
GDB v13.1优化版包含了优化过的bfd库，加载符号性能较原版本提升约10~20%。受Python的影响，GDB不支持Win10以前系统。
MinGW CRT v5~v9可以支持生成Windows 98、Windows XP应用。
以上组件皆为x86-64版本，运行在win64系统上。可以支持生成win32目标应用。
Mingw32-Make
下载 (xmake编译cmake库时需要用到，放到gcc的bin目录即可)
GDB v11.1 for Win7
下载 (Win7系统用户需单独下载此版本)
clangd v13 + CMake 3.21 + Ninja-Build 1.10
下载
第三方软件配置:
CMake，Ninja-Build，GDB需要添加到系统的PATH环境中 或 toolsets目录中。
建议使用整合包，以减少配置工作。
以下工具会从相应安装路径中自动搜索：
llvm-msvc,clangd会自动从llvm的安装路径中查找。
msvc的编译器及Windows SDK会自动搜索VisualStudio的安装路径。
Intel oneAPI编译器会自动搜索其安装路径。
mingw/msys2会自动搜索C，D，E，F盘下的msys32/msys64/mingw32/mingw64等路径。
WSL会自动搜索已经安装的WSL分发版本。
STM32Cube SDK/J-Link/ESP-IDF会自动搜索已经安装的版本。
所有搜索动作会自动进行，无需用户干预。
常用见问题
如何关联文件管理器右键菜单?
菜单栏 > 帮助 > 关联右键菜单
如何关联Win11文件管理器右键菜单?
0.4.0.819版本开始支持Win11右键菜单
但必须打开 系统设置 > 开发人员模式 > 从任意源安装应用 选项
准备好后依次运行以下命令即可：
运行 regsvr32 shell_ext.dll 手工注册文件管理器扩展
运行 powershell -command add-appxpackage -register appxmanifest.xml 注册应用
如何改变配色?
菜单栏 > 文件 > 编辑配置文件
找到 <style ...>...</style>节点
其中window="light"为浅色窗口，其中window="dark"为深色窗口
具有enabled="true"属性的style节点 或 第一个style节点 为当前配色
如何使文件管理器右键菜单打开文件到当前编辑器?
菜单栏 > 文件 > 编辑配置文件
找到config > global > single_instance
将“enabled”属性改为“true”并保存
如何关闭自绘窗口框架，使用系统默认窗口框架?
菜单栏 > 文件 > 编辑配置文件
找到config > global > custom_title
(旧版本无此配置，可参考应用根目录下的config.xml)
将“enabled”属性改为“false”保存后重启应用
(注意：这时窗口的关闭按钮会失效，可通过菜单关闭应用)
如何关闭自动格式化?
打开配置文件(文件 > 编辑配置文件)
找到config > lang[name="xxx"] > auto_formatting
(注意：每个文件类型需要单独设置)
将“enabled”属性改为“false”保存后重启应用
如何设置缩进参数?
打开配置文件(文件 > 编辑配置文件)
找到config > editor > tab
将“mode”属性改为tab/space，设置缩进模式
将“size”属性改为您希望的TAB大小
将“conv”属性改为true/false，开/关TAB<=>SPACE自动转换功能
找到config > format > indent
将“mode”属性改为tab/space，设置自动缩进模式
将“size”属性改为您希望的TAB大小
每种文件类型也可以单独设置自己的缩进参数
找到config > lang[name="xxx"] > format
设置tab/indent相关配置(与全局配置类似)
(注意：如无此配置项，可参考EDX根目录下的默认config.xml手动创建)
如何配置自动文件重加载功能?
打开配置文件(文件 > 编辑配置文件)
0.4.13.2540以后版本支持此功能，在磁盘文件修改后，自动重新加载变更(可撤销)
找到config > global > auto_reload
将“enabled”属性改为true/false，开/关此功能
将“max-lines”属性设置为允许自动重加载的最大文件行数
如何创建CMake工程?
新版本已经支持简单的工程向导，可以直接创建工程。
以下旧的创建方式依然有效:
1. 新建并打开一个空目录
2. 在“工程”面板 的右键菜单中选择 “新建” > “文件”
3. 输入文件名“CMakeLists.txt”并回车
4. 修改并保存自动生成的CMake模板
如何为CMake设置参数?
新版本已经支持CMake参数配置，在工程配置对话框>CMake面板中配置。(以下旧方式不建议使用)
打开工程根目录下自动生成的settings.lua
找到[".cmake"] = {...}配置
按如下方式修改：
[".cmake"] = {
["argument"] = {
[[-DCMAKE_PARAM1=ON]];
[[-DCMAKE_PARAM2=OFF]];
}
}
如何解决更新VS后CMake工程编译失败的问题?
菜单栏 > CMake > 重建缓存
如何设置CMake工程运行/调试目标的参数?
工程面板 > 右键菜单 > 配置 > 调试&运行
如何使用msys2中的第三方库?
使用msys2中的工具链时，可以直接引用已经安装的第三方库。但需要手动安装。
EDX中自带了msys-pkg工具，可以用于自动下载安装msys2中的第三方库，无需安装msys2相关环境。(仅支持CMake工程)
* 在CMake项目中，工程面板 > 鼠标右键菜单 > 配置 > MSYS2界面中勾选"在CMake工程中启用MSYS2支持"选项。
* 在镜像列表中选择一个适合的下载镜像服务器。
* 点击确定保存配置。EDX会自动在工程中添加msys-pkg.cmake文件，并在主工程的CMakeList.txt中添加相关引用与使用说明。
* 通过find_package(msys-xxx)引用你想要的库后，工程在编译时会自动下载/安装/更新相关的库。(可通过alt+.列出库补全列表)
* 通过target_link_libraries引用库名(上步中"xxx"部分)。如果想引用静态库，可添加"-static"后缀，如：xxx-static
使用mingw/msvc工具链时，会自动引用mingw64/mingw32目标的库。
使用llvm-mingw时会自动引用clang64/clang32目标的库。
注意！非msys2官方工具链可能会遇到兼容性问题。
注：静态库可能存在依赖顺序问题，部分库需要手动配置静态编译宏参数。llvm-mingw使用静态库可能会产生符号冲突。msvc只能使用部分动态库。
如何创建XMake工程?
创建XMake工程需要XMake相关工具，且在PATH环境中添加相关路径
检测到有效的XMake工具后，工程向导中会显示XMake工程相关选项
XMake引入第三方CMake库用整合包编译出错怎么解决?
通过xmake引用第三方库需要解决网络问题，可通过xmake g --proxy='<PROXY>'设置代理
xmake编译cmake工程时需要用到mingw32-make.exe，整合包中并未包含(
在这下载)
如何使用VCPKG中的库?
EDX会通过PATH及VCPKG_ROOT环境变量搜索vcpkg.exe
如果找到可用的vcpkg(在工具链界面中有对应的显示)，则会自动启用对vcpkg的支持。
在经典模式下，EDX会自动把已经安装的当前编译器对应版本的头文件、库路径添加到编译选项中。
此时你需要在CMakeLists.txt中添加对应的链接库(find_package仅在vc下有效，且大多数库不支持)
在清单模式下，你需要手动为工程添加vcpkg.json文件。EDX会自动为CMake添加相关的编译参数。
如何一次性折叠/展开所有代码块?
全选 > Ctrl + M, M
如何一次性折叠/展开区块下的所有代码块?
Ctrl + M, L
Ctrl + 鼠标左键 点击要折叠/展开代码块行号后的 "+"
如何快速关闭打开的多个文件?
文本编辑器 > 右键菜单 > 关闭其它文件
将关闭除当前文件外的所有其它文件
工程面板 > 选中目录 > 右键菜单 > 关闭已打开文件
将关闭当前目录下已经打开的所有文件
如何切换文件的编码?
点击状态栏中的当前编码信息，在弹出的编码菜单中选择即可
如何取消正在执行的文件搜索任务?
双击状态栏中的搜索进度即可取消当前的搜索任务
或点击搜索对话框的关闭按钮
如何中断当前的编译任务?
Ctrl + Pause
或在输出控制台执行"stop build"命令
或在 CMake菜单 选择 停止生成 (>=v0.4.8.2074)
如何附加到进程进行调试?
对于msvc目标，在输出控制台执行 windbg PID 命令
对于gcc目标，在输出控制台执行 gdb PID 命令
(PID为目标进程ID)
搜索不到我的工具链怎么办？(如何添加SSH工具链)
通过 菜单栏 > 窗口 > 面板 > 工具链 打开工具链管理界面
通过下方的 添加工具链 选择你的工具链目录
(目前仅可添加mingw系列工具链 及 linux下的SSH远程工具链)
SSH远程工具链的找不到系统头文件，无语法提示怎么办？
SSH远程工具链的系统头文件需要下载
打开工具链管理界面
选中对应的远程工具链，点击下方的 下载头文件 按钮
如何避免SSH远程开发时上传过多的文件?
SSH远程构建时只会自动更新有变更的文件
如果有不需要上传到构建服务器的文件，可通过 配置 界面设置 上传过滤器
mingw32中的gcc编译程序很慢怎么办?
binutils中的ld链接速度很慢，尤其是启用了LTO和调试信息的情况下。
使用我
优化过的Binutils能大幅(多达100倍)提升链接速度。
另: 大多数情况下，可以使用llvm中的lld来代替ld。但lld存在兼容性问题。部分程序可能无法正常链接。
适当的使用预编译头可以节约大量的编译时间。
拆分编译单元可以减少修改代码后的编译代码量。但会增加整体编译时间
合理组织代码结构，减少代码依赖关系。有利于减少编译的代码量。
C++中的模板是影响编译速度的重要因素。
为什么C++没有语法提示?
C++的语法提示依赖于clangd。请确保系统中安装了clangd。或clangd在搜索路径里。
如果语言服务中有日志，说明clangd已经启动。
此时，语法提示仍然不正常可能是编译器环境异常，或Clangd不支持你使用的编译器。
请
提交ISSUE，我会尽可能做兼容处理。
Clangd崩溃了怎么办?
请尝试使用最新的官方发行版本
在输出控制台执行reset lsp可以重启clangd
自0.4.4.1678版开始，EDX默认开启了clangd的并行索引功能，此功能易导致clangd崩溃。
在lsp.lua中搜索并注释掉代码行 "--j=8" 可关闭并行索引。
Clangd在工程(WSL/SSH)中有中文路径时无法正常工作?
如何自定义快捷键?
自0.4.5.1701版开始，实现了新的用户自定义脚本加载机制。可通过用户脚本配置快捷键。
配置文件位置如下：
全局配置
{USER}/AppData/Local/ed-x.cc/edx/user-config.lua
{EDX ROOT}/user-config.lua
以上两处位置，按优先顺序加载其中之一。
工程配置
{PROJECT}/.edx/user-config.lua
注册代码如下：
1. 注册新的快捷键，保留原快捷键，不更新菜单
edx.register_short_cuts(_op_scope._global, {_op.next_buffer, k("ctrl+alt+n")});
edx.register_short_cuts(_op_scope._global, {_op.prev_buffer, k("ctrl+alt+p")});
2.
更新快捷键，会注销 原有操作 的对应快捷键，并更新对应操作的菜单。
!!!如果快捷键在其它范围被绑定到了其它操作命令上，并不会被注销此操作!!!
update_short_cuts(_op_scope._global, { _op.next_buffer, k("ctrl+alt+n") });
update_short_cuts(_op_scope._global, { _op.prev_buffer, k("ctrl+alt+p") });
参数1为快捷键作用范围。参数2为 {命令id， 快捷键序列...}。
注：当新注册的快捷键与系统原有快捷键冲突时，需要先注销系统绑定的操作。如下：
update_short_cuts(_op_scope._global, { _op.next_buffer }); // 注销原 _op.next_buffer 操作绑定的快捷键 ctrl+alt+n
update_short_cuts(_op_scope._global, { _op.new_op, k("ctrl+alt+n") }); // 绑定 ctrl+alt+n 到 _op.new_op
怎么编译/调试单个源文件?
在无工程时，打开单独的C/C++源代码可以直接编译/调试。
在工程中，编译非工程内的单个源文件需要在首行添加工具链注释。如下：
// toolset:[工具链名称]
如果有特别的编译参数、运行参数需要配置，也可以在文件首部添加工具链注释。如下：
// args: 运行参数1 运行参数2
// flags: /Debug
// lib: gdi32
在文件首部添加“//”后，按 Alt + . 会弹出相关的补全提示。
如何用EDX制作Portable开发环境?
EDX不会主动读写系统注册表，不会依赖特定系统目录/文件。
默认情况下，EDX的配置和用户数据会保存在当前用户的AppData/Local/ed-x.cc/edx目录下。
当edx主程序目录下存在".edx-data"目录时，会使用此目录代替用户的AppData目录。
EDX在搜索工具链时，会搜索主程序目录下的toolsets目录，工具链可放到此目录下。
具体结构可参考gcc/llvm-mingw整合包的结构。
注意：仅支持mingw/llvm-mingw/cmake/xmake等相关工具
如何用EDX开发ESP-IDF项目?
0.4.9.2135版本重新修复了对ESP-IDF的支持，并支持在不同版本的SDK之间切换。
安装完成以后，需要手工执行 <IDF_TOOLS_PATH>/frameworks/esp-idf-vX.X.X/install.bat 进行ESP-IDF的初始化。
(可能需要联网下载部分组件，部分组件可能需要代理服务器才能顺利下载)
ESP-IDF初始化完成后，即可使用EDX打开ESP-IDF项目。
(EDX会通过IDF_TOOLS_PATH环境变量定位ESP-IDF SDK，请确保此变量设置正确。安装ESP-IDF会自动设置此变量)
多个不同版本的ESP-IDF请确保安装在同一IDF_TOOLS_PATH下。
如何用EDX开发ESP8266项目?
0.4.9.2135版本添加对ESP8266_RTOS_SDK的支持。
你需要首先安装ESP-IDF的SDK，见上面内容。
把ESP8266_RTOS_SDK-v3.4.zip解压到<IDF_TOOLS_PATH>/frameworks目录下。
下载地址
确保目录结构为 <IDF_TOOLS_PATH>/frameworks/ESP8266_RTOS_SDK
ESP8266_RTOS_SDK没有提供install.bat，你需要参考install.sh中的步骤手工执行初始化。
* 在命令行中执行 tools\idf_tools.py install 安装相关工具
* 在命令行中执行 tools\idf_tools.py install-python-env 安装Python虚拟环境
提示：Python虚拟环境可复制ESP-IDF生成的，只需要重命名为rtos3.4_py3.11_env即可
初始化需要安装Python，下载过程中需要联网，有可能需要使用代理服务器
初始化完成后即可在EDX中使用ESP8266_RTOS_SDK。
ESP8266_RTOS_SDK不支持多版本并存。
快捷键列表:
文件
新建文件 Ctrl + N
打开文件 Ctrl + O
打开目录 Alt + O
打开文件到当前缓冲 Ctrl + Shift + O
关闭当前文件 Ctrl + F4
保存文件 Ctrl + S
另存文件为 Ctrl + Shift + S
保存所有文件 Ctrl + Shift + A
移动光标
移动光标(单个字符) ←
→
移动光标(整个单词) Ctrl + ←
Ctrl + →
移动光标到行首 Home
移动光标到行尾 End
行移动光标 ↑
↓
整页移动光标 PageUp
PageDown
移动光标到首行 Ctrl + Home
移动光标到尾行 Ctrl + End
移动光标到对应括号 Ctrl + ]
移动光标到指定行号 Ctrl + G
移动光标到前一历史位置 Ctrl + -
移动光标到后一历史位置 Ctrl + Shift + -
选择
全选 Ctrl + A
取消选中区域 Esc
扩展选区(单个字符) Shift + ←
Shift + →
扩展选区(整个单词) Ctrl + Shift + ←
Ctrl + Shift + →
扩展选区到首行 Shift + Home
扩展选区到尾行 Shift + End
向上选中一页 Shift + PageUp
向下选中一页 Shift + PageDown
扩展选区到对应括号 Ctrl + Shift + ]
选中当前单词 Ctrl + W
列选择 Alt + Shift + ←
Alt + Shift + →
Alt + Shift + ↑
Alt + Shift + ↓
Alt + Shift + 鼠标左键单击
Alt + 鼠标左键拖选
编辑
向上插入新行 Shift + Enter
向下插入新行 Ctrl + Enter
删除后一个字符 Delete
删除前一个字符 Backspace
删除整行 Shift + Delete
删除选区 Delete (选中状态)
Backspace (选中状态)
删除到后一个单词 Ctrl + Delete
删除到前一个单词 Ctrl + Backspace
剪切整行 Ctrl + X
剪切选区 Ctrl + X (选中状态)
撤销 Ctrl + Z
复制整行 Ctrl + C
复制选区 Ctrl + C (选中状态)
重做 Ctrl + Y
粘贴 Ctrl + V
循环粘贴 Ctrl + Shift + V
重复整行 Ctrl + D
重复选区 Ctrl + D (选中状态)
增加缩进 Tab (选中状态)
减少缩进 Shift + Tab
格式化 Ctrl + K，Ctrl + F
Ctrl + K，F
注释代码 Ctrl + K，Ctrl + C
Ctrl + K，C
取消注释 Ctrl + K，Ctrl + U
Ctrl + K，U
切换选区/光标行注释状态 Ctrl + /
选中文本转为小写 Ctrl + U
选中文本转为大写 Ctrl + Shift + U
快速修复
Alt
+
Enter
(在含有错误/诊断提示的行)
此功能依赖clangd的Code Action能力，并不是所有异常都有修复方案。
由于clang的BUG，部分修复结果是错误的，但可供参考
受clangd的响应速度影响，对大型文件修复需要等待上一次的修复完成，且clangd发布了新的诊断信息。
否则，将产生异常的结果。
查找替换
查找 Ctrl + F
多文件查找 Ctrl + Shift + F
替换
Ctrl
+
H
多文件替换
Ctrl
+
Shift
+
H
(仅支持在已经打开的多个文件中替换)
查找下一项 F3
查找上一项 Shift + F3
增量查找 Ctrl + I
向上增量查找 Ctrl + Shift + I
查找帮助信息 F1
代码提示与导航
列出成员/补全 Alt + .
显示参数信息 Alt + ,
显示符号信息 Ctrl + Q
鼠标悬停
跳转到头文件 Ctrl + Shift + G
跳转到声明/定义 F12
列举当前文件结构 Ctrl + F12
查找实现 Alt + F12
查找引用 Shift + F12
定位当前文件 Alt + L
定位下一处问题 Alt + N
定位上一处问题 Alt + Shift + N
编译/调试
编译当前项目 Ctrl + B
停止编译 Ctrl + Break
Ctrl + Pause
编译所有项目 Ctrl + Shift + B
重新生成所有项目 Ctrl + Alt + F7
编译并运行 Ctrl + F5
启动调试器 F5
终止调试 Shift + F5
中断运行 Ctrl + F9
步过 F10
步入 F11
步出 Shift + F11
跳转执行点 Alt + F9 (仅对当前栈帧有效，有可能引起帧错误)
切换断点 F9
列举所有断点 Ctrl + Alt + B
窗口
切换到下个文件 Ctrl + Tab
切换到上个文件 Ctrl + Shift + Tab
切换全屏 Alt + Shift + Enter
切换到文本编辑器 Esc (文本编辑器在非焦点状态下)
切换到工程面板 Ctrl + Alt + L
切换到类视图面板 Ctrl + Alt + E
切换到输出面板 Ctrl + Alt + O
切换到查找面板 Ctrl + Alt + F
切换到调试器面板 Ctrl + Alt + D
切换到局部变量 Ctrl + Alt + A
切换到监视面板 Ctrl + Alt + W
切换到调用栈 Ctrl + Alt + C
切换到线程面板 Ctrl + Alt + S
切换到模块面板 Ctrl + Alt + M