Maven 批处理脚本与 Qoder 配置使用指南
Maven 批处理脚本编写与 Qoder 配置使用指南
一、背景说明
在 Java 项目开发过程中，经常需要执行 Maven 清理、编译、打包等操作。为了提高效率，我们可以编写批处理脚本自动化这些流程，并在 Qoder 中配置使用。
适用场景
- Spring Boot / Spring AI 项目开发
- 需要频繁清理缓存和重新编译
- 使用外置 Maven 而非环境变量配置
- 需要指定特定 JDK 版本进行编译
注：
博客：
https://blog.csdn.net/badao_liumang_qizhi
二、完整批处理脚本
maven-clean-rebuild.bat
batch
@echo off
chcp 65001 >nul
echo ========================================
echo Maven 清理和重新编译脚本
echo ========================================
echo.
REM ===== 配置区 =====
REM 设置外置 Maven 的路径（请根据实际情况修改）
set MAVEN_PATH=D:\apache-maven-3.9.6\bin\mvn.cmd
REM 设置 JDK 17 的路径（请根据实际情况修改）
set JAVA_HOME=D:\jdk-17
set PATH=%JAVA_HOME%\bin;%PATH%
REM ===== 检查 Maven 是否存在 =====
if not exist "%MAVEN_PATH%" (
echo [错误] 找不到 Maven 可执行文件: %MAVEN_PATH%
echo 请在脚本中修改 MAVEN_PATH 为正确的 Maven 路径
pause
exit /b 1
)
echo [步骤 0] 检查 Java 版本...
echo.
java -version
echo.
REM ===== 检查 Java 版本是否为 17 或以上 =====
java -version 2>&1 | findstr /C:"version \"17" >nul
if %ERRORLEVEL% NEQ 0 (
java -version 2>&1 | findstr /C:"version \"18" >nul
if %ERRORLEVEL% NEQ 0 (
java -version 2>&1 | findstr /C:"version \"19" >nul
if %ERRORLEVEL% NEQ 0 (
java -version 2>&1 | findstr /C:"version \"20" >nul
if %ERRORLEVEL% NEQ 0 (
java -version 2>&1 | findstr /C:"version \"21" >nul
if %ERRORLEVEL% NEQ 0 (
echo [错误] 当前 Java 版本不是 17 或更高版本
echo 请安装 JDK 17+ 并在脚本中设置 JAVA_HOME
echo 当前 Java 版本：
java -version
pause
exit /b 1
)
)
)
)
)
echo [成功] Java 版本检查通过
echo.
echo [步骤 1] 清理 Maven 本地缓存...
echo.
REM ===== 删除特定框架的本地缓存 =====
echo 正在删除 Spring AI 相关缓存...
if exist "%USERPROFILE%\.m2\repository\org\springframework\ai" (
rmdir /s /q "%USERPROFILE%\.m2\repository\org\springframework\ai"
echo [成功] 已删除 org\springframework\ai 缓存
) else (
echo [提示] 未找到 org\springframework\ai 缓存
)
if exist "%USERPROFILE%\.m2\repository\com\alibaba\cloud\ai" (
rmdir /s /q "%USERPROFILE%\.m2\repository\com\alibaba\cloud\ai"
echo [成功] 已删除 com\alibaba\cloud\ai 缓存
) else (
echo [提示] 未找到 com\alibaba\cloud\ai 缓存
)
echo.
echo [步骤 2] 清理项目...
echo.
call "%MAVEN_PATH%" clean
echo.
echo [步骤 3] 强制更新依赖并重新编译...
echo.
call "%MAVEN_PATH%" clean compile -U -e
echo.
echo ========================================
if %ERRORLEVEL% EQU 0 (
echo [成功] 编译完成！
) else (
echo [失败] 编译失败，请检查错误信息
)
echo ========================================
echo.
pause三、批处理脚本语法详解
基础命令
| 语法/命令 | 说明 | 示例 |
|---|---|---|
@echo off |
关闭命令回显，不在屏幕显示执行的命令 | @echo off |
chcp 65001 |
设置控制台编码为 UTF-8，支持中文显示 | chcp 65001 >nul |
>nul |
将命令输出重定向到空设备，不显示输出 | echo. >nul |
echo. |
输出空行 | echo. |
set VAR=value |
设置环境变量 | set JAVA_HOME=D:\jdk-17 |
%VAR% |
引用变量值 | echo %JAVA_HOME% |
pause |
暂停脚本执行，等待用户按键 | pause |
条件判断
| 语法/命令 | 说明 | 示例 |
|---|---|---|
if not exist |
检查文件或路径是否存在 | if not exist "%MAVEN_PATH%" |
if exist |
检查文件或路径是否存在 | if exist "path" |
%ERRORLEVEL% |
获取上一个命令的返回码（0 表示成功） | if %ERRORLEVEL% EQU 0 |
NEQ / EQU |
数值比较：不等于 / 等于 | if %ERRORLEVEL% NEQ 0 |
exit /b 1 |
退出脚本，返回错误码 1 | exit /b 1 |
字符串处理
| 语法/命令 | 说明 | 示例 |
|---|---|---|
findstr |
字符串查找命令 | findstr /C:"version" |
/C:"string" |
精确匹配字符串 | findstr /C:"17" |
2>&1 |
将标准错误输出重定向到标准输出 | java -version 2>&1 |
| ` | ` | 管道符，将前一个命令的输出作为后一个命令的输入 |
文件和目录操作
| 语法/命令 | 说明 | 示例 |
|---|---|---|
rmdir /s /q |
递归删除目录，不提示确认 | rmdir /s /q path |
call |
调用另一个批处理程序或命令 | call "%MAVEN_PATH%" clean |
REM 注释
batch
REM 这是单行注释
REM 用于解释代码功能，不会被执行四、脚本核心逻辑解析
1. 环境配置区
batch
REM 设置外置 Maven 的路径
set MAVEN_PATH=D:\apache-maven-3.9.6\bin\mvn.cmd
REM 设置 JDK 17 的路径
set JAVA_HOME=D:\jdk-17
set PATH=%JAVA_HOME%\bin;%PATH%说明：
- 使用
set命令设置环境变量 MAVEN_PATH：指定 Maven 可执行文件的完整路径JAVA_HOME：指定 JDK 安装路径PATH：将 JDK 的 bin 目录添加到系统路径前面，优先使用
2. 环境检查区
batch
if not exist "%MAVEN_PATH%" (
echo [错误] 找不到 Maven 可执行文件
pause
exit /b 1
)说明：
- 检查 Maven 可执行文件是否存在
- 如果不存在，输出错误信息并退出脚本
exit /b 1表示以错误状态码退出
3. Java 版本检查
batch
java -version 2>&1 | findstr /C:"version \"17" >nul
if %ERRORLEVEL% NEQ 0 (
echo [错误] Java 版本不是 17 或更高版本
exit /b 1
)说明：
java -version：显示 Java 版本信息（输出到标准错误）2>&1：将标准错误重定向到标准输出|：管道符，将输出传递给下一个命令findstr /C:"version \"17"：查找包含version "17的行>nul：不显示 findstr 的输出%ERRORLEVEL%：findstr 的返回码，0 表示找到，非 0 表示未找到NEQ 0：如果不等于 0（未找到），则执行错误处理
测试效果
