ECommandPrompt

KO | EN

gitlite — search

#javascript #python #react #llm #golang #go #rust #docker #windows #cli #kubernetes #mcp #openai #open-source

(★ 8)

易语言命令行工具

ECommandPrompt Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 易语言命令行编译工具

易语言命令行编译工具用于在命令行中编译易语言源码文件，便于自动构建、批处理和部署流程。当前项目版本为 `1.2.5.6(beta)`，生成的 Win32 可执行文件名为 `ecl.exe`。

本工具不是易语言编译器本体。运行时会启动本机安装的易语言程序，并通过自动化方式触发普通编译、独立编译、静态编译、黑月编译、易包编译或调试运行等动作。

## 功能特性

- 支持普通编译、独立编译、静态编译、黑月编译、易包编译和调试运行。
- 支持通过 `-epath` 或 `ecl.ini` 指定易语言程序路径。
- 支持编译带密码的源码。
- 支持额外加载易语言支持库。
- 支持临时修改编译后的文件版本号、常量、图片资源和声音资源。
- 支持临时覆盖部分易语言系统编译配置。
- 支持静默输出、UTF-8 输出和从命令文件读取参数。

## 目录结构

```text
.
├─ ECommandPrompt.sln          Visual Studio 解决方案
├─ src/
│  ├─ ECommandPrompt.cpp       命令行入口和参数解析
│  ├─ GoCompile.cpp/.h         启动易语言并执行编译的核心逻辑
│  ├─ Common.cpp/.h            通用工具、源码类型识别、远程进程辅助等
│  ├─ md5t.cpp/.h              MD5 辅助实现
│  ├─ ECommandPrompt.rc        版本信息和内置资源
│  └─ res/
│     ├─ EclHelp.txt           程序内置帮助文本
│     └─ SaveE40_*.dat         易语言 4.0 相关内置资源
├─ img/                        项目图片资源
├─ update.txt                  更新记录
└─ Release/                    已生成的发布包和示例文件
```

## 构建

推荐使用 `Release|Win32` 构建。

### 环境要求

- Windows
- Visual Studio 2017 或兼容的 MSVC 工具链
- C++ 桌面开发组件
- Win32 配置按工程原设置使用 `v141_xp` 工具集
- 本机需要安装易语言，运行编译命令时还需要能正常启动对应的 `e.exe`

### 使用 Visual Studio 构建

1. 打开 `ECommandPrompt.sln`。
2. 选择 `Release|Win32`。
3. 执行生成。
4. 输出文件通常位于 `Release\ecl.exe`。

## 基本用法

```bat
ecl.exe make "C:\test.e"
```

### 设置默认易语言路径

```bat
ecl.exe set epath "C:\Program Files (x86)\e\e.exe"
```

该命令会在 `ecl.exe` 同目录写入 `ecl.ini`。执行 `make` 时，工具按以下顺序寻找易语言路径：

1. 命令行参数 `-epath`
2. `ecl.exe` 同目录的 `ecl.ini`
3. 注册表中的易语言源码文件打开命令

### 编译源码

```bat
ecl.exe make Source [Target] [options]
```

- `Source`：易语言源码完整路径，例如 `"C:\test.e"`。
- `Target`：输出文件路径，可省略。省略时默认输出到源码所在目录，文件名与源码相同，并按源码类型自动追加扩展名。

示例：

```bat
ecl.exe make "C:\test.e"
ecl.exe make "C:\test.e" "C:\Release\test.exe"
ecl.exe make "C:\test.e" -epath "C:\Program Files (x86)\e\e.exe" -s
ecl.exe make "C:\test.e" -pwd "The Password"
ecl.exe make "C:\test.e" -bm -bmcfg "默认配置"
```

## 常用参数

| 参数 | 说明 |
| --- | --- |
| `-epath path` | 指定易语言程序路径 |
| `-d` | 独立编译 |
| `-s` | 静态编译 |
| `-bm` | 黑月编译 |
| `-bm0` | 黑月汇编模式编译，旧版黑月有效 |
| `-bm1` | 黑月 C++ 模式编译，旧版黑月有效 |
| `-bm2` | 黑月 MFC 模式编译，旧版黑月有效 |
| `-p` | 编译易包 |
| `-r` | 调试运行 |
| `-bmcfg config` | 指定黑月配置名称 |
| `-bmdes description` | 指定黑月特定备注 |
| `-pwd password` | 指定源码密码 |
| `-lib libs` | 指定额外支持库，多个支持库用分号分隔，不需要 `.fne` 后缀 |
| `-show` | 显示易语言窗口 |
| `-k` | 执行结束后等待按键，不立即退出 |
| `-st seconds` | 启动易语言超时时间，默认 300 秒 |
| `-ct seconds` | 编译超时时间，默认 600 秒 |
| `-q` | 静默模式，只输出错误信息 |
| `-nologo` | 不打印版权横幅 |
| `-utf8` | 以 UTF-8 输出信息 |
| `-unicode` | 以 Unicode 输出信息 |

如果命令行输出出现乱码，可以尝试添加 `-utf8` 或 `-unicode`。

## 编译时临时修改源码数据

下面这些参数只影响本次编译，不会修改源码文件本身。

### 修改版本号

```bat
ecl.exe make "C:\test.e" -ver 1.2.4.9
```

### 修改常量

```bat
ecl.exe make "C:\test.e" -const "常量1=1;常量2="""文本""";常量3=@c:\c3.txt"
```

支持数值、文本、时间、逻辑值和从文件读取长文本。命令行中连续三个引号表示一个被转义的引号。

### 修改图片或声音资源

```bat
ecl.exe make "C:\test.e" -pic "图片1=@c:\p1.bmp;图片2=@..\p2.bmp"
ecl.exe make "C:\test.e" -sound "声音1=@c:\s1.wav"
```

资源路径可以使用绝对路径；相对路径会按源码所在目录解析。

## 易语言系统配置参数

| 参数 | 说明 |
| --- | --- |
| `-FastArry` / `-FastArry-` | 开启或关闭快速数组访问方式，默认关闭 |
| `-CheckDllStack` / `-CheckDllStack-` | 开启或关闭 DLL 调用后堆栈检查，默认开启 |
| `-CheckLoop` / `-CheckLoop-` | 开启或关闭死循环代码检查，默认开启 |
| `-Windows6.0` / `-Windows6.0-` | 使用或不使用 Windows 通用组件库 6.0，默认不使用 |
| `-UAC` / `-UAC-` | 运行前是否请求管理员权限，默认不请求 |
| `-OutLib` / `-OutLib-` | 非独立编译后是否写出相关库，默认不写出 |
| `-CheckName` / `-CheckName-` | 开启或关闭严格的重复名称检查，默认关闭 |
| `-JunkLevel level` | 花指令级别，默认 0，最大 3 |
| `-Upset value` | 编译结果打乱码，默认 0，随机打乱可用 `0xFFFFFFFF` |
| `-KeepEConfig` | 不改变易语言系统配置 |
| `-KeepLibList` | 不改变支持库列表 |

## link.ini 参数

可以通过 `-e_xxx` 形式临时指定易语言 `link.ini` 配置项。工具不会永久修改 `link.ini`，只在本次编译流程中传递配置。

常见示例：

```bat
ecl.exe make "C:\test.e" -e_linker "\VC98linker\Bin"
```

已解析的配置项包括：

- `-e_linker`
- `-e_output_file`
- `-e_extra_args`
- `-e_show_command_line`
- `-e_retain_intermediate_files`
- `-e_show_warning`

## 从文件读取命令行

命令参数可以写入文本文件，再通过 `@文件路径` 传入。文件中的不同参数可以用空格或换行分隔。

```bat
ecl.exe @test.txt
```

`test.txt` 示例：

```text
make
"C:\test.e"
-epath "C:\Program Files (x86)\e\e.exe"
-d
```

## 返回码

| 返回码 | 含义 |
| --- | --- |
| `1` | 处理成功 |
| `0` | 未发生错误 |
| `-1` | 未定义类型的错误 |
| `-2` | 命令行有错误 |
| `-3` | 找不到文件 |
| `-4` | 文件无效 |
| `-5` | 编译失败 |
| `-6` | 不支持的编译类型 |
| `-7` | 无法识别或无法运行易语言程序 |
| `-8` | 无法获取易语言菜单 |
| `-9` | 易语言意外结束 |
| `-10` | 静态编译失败 |
| `-11` | 生成 `link.ini` 文件过程中出错 |
| `-12` | 老版黑月的相关数据无法定位 |
| `-13` | 黑月编译失败 |
| `-14` | 源码密码不正确 |
| `-15` | 缺乏易模块 |
| `-16` | 缺少支持库 |
| `-17` | 启动易语言超时 |
| `-18` | 编译超时 |
| `-19` | 不支持易包编译 |

## 更新记录

最新记录见 `update.txt`。当前版本 `1.2.5.6` 的主要变化：

- 增加 `-KeepLibList` 参数。
- 修复部分系统下输出信息不可读的问题。
- 修复其他若干问题。

## 注意事项

- 某些源码依赖插件支持库时，需要通过 `-lib` 手动指定支持库名称。
- 本工具会启动并调试/控制易语言进程，杀毒软件或安全策略可能影响运行。
- 构建输出和发布包位于 `Debug/`、`Release/` 等目录，这些目录通常不建议作为源码改动提交。

ECommandPrompt

ECommandPrompt Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

ECommandPrompt

ECommandPrompt Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README