批处理脚本中如何将彩色编译提示固定在命令窗口首行？

核心思路 #

借助Windows控制台的ANSI转义序列（Windows 10及以上系统默认支持）控制光标位置与文本颜色，把编译提示固定在首行；后续编译任务的输出从第二行开始打印，避免顶掉首行内容，同时支持动态更新首行提示文本。

具体实现代码 #

@echo off
setlocal EnableDelayedExpansion

:: 隐藏光标（可选，减少闪烁）
echo ^[[?25l

:: 初始化首行彩色提示
call :update_header "Compiling Project A"

:: 执行编译任务，将输出定向到第二行及以后
call buildFunction22 > >(
    for /f "delims=" %%a in ('findstr /n "^"') do (
        :: 定位到第二行首列，清除该行后输出内容
        echo ^[[2;1H^[[K%%a
        :: 强制光标回到当前输出行末尾，避免后续输出错位
        echo ^[[E
    )
)

:: 编译完成后恢复光标显示（可选）
echo ^[[?25h
endlocal
exit /b

:: 更新首行提示的函数
:update_header
:: 定位到首行首列→清除该行→输出彩色文本→重置颜色
echo ^[[1;1H^[[K^[[31m%~1^[[0m
exit /b

关键细节说明 #

• 光标与内容控制：
  • ^[[1;1H：将光标精准定位到第1行第1列；^[[K：清除当前行的所有内容，确保新提示能完全覆盖旧文本。
  • ^[[2;1H：把光标移到第2行首列，让编译输出从这里开始，不会干扰首行。
• 颜色设置：
  • ^[[31m代表红色文本，可替换为其他颜色代码：绿色^[[32m、黄色^[[33m、蓝色^[[34m等；^[[0m用于重置颜色，避免后续输出继承彩色格式。
• 动态更新提示：
  当需要切换到「Compiling Project B」时，直接调用call :update_header "Compiling Project B"即可，该命令会回到首行覆盖原有内容，不影响下方的编译输出。

兼容旧系统方案（Windows 7及以下） #

如果环境不支持ANSI转义序列，可通过mode命令固定窗口高度，配合cls和光标定位模拟效果，但体验稍差：

@echo off
setlocal EnableDelayedExpansion

:: 固定窗口高度为25行（可根据需要调整）
mode con lines=25

:: 初始化首行提示
call :update_header_old "Compiling Project A"

:: 执行编译任务，输出到临时文件后逐行打印到第二行及以后
call buildFunction22 > temp_build.log
for /f "delims=" %%a in (temp_build.log) do (
    echo ^[[2;1H%%a
    echo ^[[E
)
del temp_build.log

endlocal
exit /b

:update_header_old
cls
color 0C
echo %~1
color 07
:: 定位到第二行首列
echo ^[[2;1H
exit /b

内容的提问来源于stack exchange，提问作者djv