ECommandPrompt 是易语言命令行编译工具,最终编译产物为 ecl.exe,可用于批量、自动化编译易语言源码。本项目为标准 Visual Studio C++ 工程,编译流程简单。易语言命令行编译工具用于在命令行中编译易语言源码文件,便于自动构建、批处理和部署流程。当前项目版本为 1.2.5.6(beta),生成的 Win32 可执行文件名为 ecl.exe。本工具不是易语言编译器本体。运行时会启动本机安装的易语言程序,并通过自动化方式触发普通编译、独立编译、静态编译、黑月编译、易包编译或调试运行等动作。
一、编译环境要求
- Windows 操作系统
- Visual Studio 2017 及以上版本(推荐 2019/2022)
- 安装「使用 C++ 的桌面开发」工作负载
- 可选:安装 v141_xp 平台工具集(工程默认配置,用于兼容 Windows XP 系统)
- 最终运行 ecl.exe 的机器上,需要安装可正常启动的易语言 IDE
二、详细编译步骤
1. 解压源码
将 ECommandPrompt-master.zip 完整解压到无中文、无空格的目录,例如 D:\dev\ECommandPrompt-master。
2. 打开解决方案
进入解压后的根目录,双击打开 ECommandPrompt.sln 解决方案文件。
3. 选择编译配置
在 Visual Studio 顶部工具栏中,设置:
- 解决方案配置:Release
- 解决方案平台:Win32(本项目仅支持 32 位编译)
4. 执行编译
点击顶部菜单「生成」→「生成解决方案」,或按快捷键 Ctrl+Shift+B 开始编译。
三、编译产物位置
编译成功后,可执行文件位于工程根目录下:
Release\ecl.exe
四、工具集兼容说明
工程默认使用 v141_xp 平台工具集,若你的 Visual Studio 未安装该组件,有两种处理方式:
- 在 Visual Studio Installer 中勾选「对 v141 生成工具的 C++ Windows XP 支持」并安装
- 右键项目 → 属性 → 常规 → 平台工具集,改为当前 VS 版本对应的默认工具集(如 v143),编译后的程序将不再兼容 XP 系统
五、快速验证编译结果
打开命令提示符,进入 Release 目录,执行以下命令查看帮助信息:
ecl.exe /?
若正常输出版本信息与参数列表,说明编译成功。
六、常见编译问题
- 1. 提示找不到 Windows SDK
- 右键项目 → 属性 → 常规 → Windows SDK 版本,选择本机已安装的 SDK 版本即可。
- 2. 中文注释或字符串乱码
- 本项目源码已统一为带 BOM 编码,直接使用默认设置编译即可,无需额外修改字符集选项。
- 3. 编译成功但运行报错
- ecl.exe 运行依赖本机已安装的易语言 IDE,请确保易语言可正常启动并通过注册表关联 .e 文件。
功能特性
(可选)命令行方式编译
合自动化、脚本构建场景:
1. 打开开始菜单里的「x86 Native Tools Command Prompt for VS 2022」(对应你的 VS 版本)
2. 进入源码根目录:
cd /d D:\dev\ECommandPrompt-master
3. 执行编译命令:
msbuild ECommandPrompt.sln /p:Configuration=Release /p:Platform=Win32 /m
4. 编译完成后,产物同样在 Release\ecl.exe
最常见报错:v141_xp 工具集不存在
如果你用 VS2022 且没装 XP 支持工具集,打开工程会直接报错,按以下步骤修改:
1. 在 VS 右侧「解决方案资源管理器」中,右键 ECommandPrompt`项目 →「属性」
2. 左侧选择「配置属性」→「常规」
3. 找到「平台工具集」,把 Visual Studio 2017 - Windows XP (v141_xp)`改为:
- VS2022 选 `Visual Studio 2022 (v143)`
- VS2019 选 `Visual Studio 2019 (v142)`
4. 点击「确定」保存,重新生成即可。
注意:修改后编译出的程序将不再兼容 Windows XP 系统,不影响正常 Win7/10/11 使用。