在批处理脚本中利用&&命令将多条命令优雅的拼接在一起

简要介绍在Windows系统中采用基于CMD的批处理脚本进行自动化部署时，对通过&&拼接的指令以更优雅的方式实现，以提高批处理脚本的可读性和可维护性。

问题说明

项目背景

公司有个基于Python开发的项目近期要交付给客户，为了便于安装和后续升级，之前都是采用PyInstaller安装成exe可执行文件实现傻瓜式的操作，而这个项目出于避免与客户服务器其它Python环境冲突以及便于后续扩展的考量，在软件部署和升级时采用了Anaconda进行隔离式部署，其部署流程如下¹

各步骤涉及到的操作主要有:

1. 创建conda环境，conda create -n lyq_test -y
2. 激活conda环境，conda activate lyq_test
3. 安装pip依赖，pip install -r requirements.txt
4. 执行python程序，python hello.py

这些步骤对于专业的开发人员而言操作起来很快速，但对于相关的使用客户而言，他们不一定具有相关的编程经验，执行上述指令容易出错，便利性有待提高。

由于目标客户的环境为Windows，同项目成员沟通后决定采用CMD批处理脚本来包含上述命令，实际部署或升级时只需要运行该批处理脚本即可。

面临的问题

最开始采用的install.bat批处理脚本类似如下

@echo off
title 一键部署与升级脚本
echo ===========开始创建conda环境==============
conda create -n lyq_test -y
conda activate lyq_test
pip install -r requirements.txt
python hello.py
pause

运行结果如下，可发现从conda create -n lyq_test -y之后的指令均没有执行

一开始自己以为是由于Anaconda的创建需要时间，于是参考Stackoverflow中的说明²在conda activate之前添加了一条睡眠指令，测试结果和上图一样，问题依旧。

@echo off
title 一键部署与升级脚本
echo ===========开始创建conda环境==============
conda create -n lyq_test -y
rem 睡眠10秒钟
ping -n 10 127.0.0.1 > nul
conda activate lyq_test
pip install -r requirements.txt
python hello.py
pause

参考网上的资料和自己尝试后发现将批处理脚本中的命令用&&³拼接起来然后一起执行就能达到要求

@echo off
title 一键部署与升级脚本
echo ===========开始创建conda环境==============
conda create -n lyq_test -y && conda activate lyq_test && pip install -r requirements.txt && python hello.py
pause

运行结果如下，虽然批处理脚本的执行结果符合自己的预期，但此种解决方案带来了一个很严重的副作用

通过&&将多条指令拼接在一起的结果是脚本中只有一条超长的指令，会导致批处理脚本的可读性和可维护性都严重降低！

解决方案

由于随着项目的进行，install.bat脚本肯定会进行不断地修正与更新，install.bat脚本的可维护性与可读性是必须要解决的问题，但采用&&拼接的方式也不能放弃，只能另想它法。

继续寻求Stackoverflow⁴的协助⁵，将install.bat通过SET来重新赋值的方式进行变量拼接，修改后的代码如下

@echo off
title 一键部署与升级脚本
echo ===========开始创建conda环境==============
set command=conda create -n lyq_test -y 
set command=%command% && conda activate lyq_test
set command=%command% && pip install -r requirements.txt
set command=%command% && python hello.py
echo 拼接后的命令如下
echo %command%
echo 开始执行拼接后的命令
%command%
pause

执行结果如下，虽然能成功进入Anaconda环境，但是后续的指令都没有执行。

看起来似乎是胜利在望，但仔细分析后发现只所以能进入Anaconda环境是由于第1个&&配置生效，导致批处理文件提前执行，而后续的拼接指令没有机会执行⁶，还是没法实现最终目的。

为了避免提前执行，尝试用双引号将相关指令封装起来，在拼接完成后统一执行

@echo off
title 一键部署与升级脚本
echo ===========开始创建conda环境==============
set "command=conda create -n lyq_test -y" 
set "command=%command% && conda activate lyq_test"
set "command=%command% && pip install -r requirements.txt"
set "command=%command% && python hello.py"
echo 拼接后的命令如下
echo %command%
echo 开始执行拼接后的命令
%command%
pause

执行结果如下，虽然最终的执行结果符合预期，但很明显打印出来的拼接数据不是我们想要的，不利于后续分析，同时一些echo打印指令没有执行，此方案存在瑕疵，实际使用中风险很大。

经过一段时间的搜索后没有找到自己想要的答案，只能在Stackoverflow上提问希望能获得帮助，最终通过⁷得到了一个较为满意的解决方案。

该方案主要通过字符串截取来实现⁸，修改后的脚本如下

@echo off
title 一键部署与升级脚本
echo ===========开始创建conda环境==============
set command=conda create -n lyq_test -y
rem 要特别注意第1次拼接时不能加上:~1,-1
set command="%command% && conda activate lyq_test"
set command="%command:~1,-1% && pip install -r requirements.txt"
set command="%command:~1,-1% && python hello.py"
echo ==========拼接后的命令如下===========
echo %command%
echo ==========开始执行拼接后的命令============
%command:~1,-1%
pause

脚本执行结果如下，结果符合预期，在确保脚本能正常执行的前提下也满足了可维护性与可读性，问题解决!