一文详解bat批处理脚本中的目录切换与路径管理

@echo off                     :: 关闭命令回显，使脚本运行时不会显示执行的命令
:: cd 新目录               :: 中文注释（疑似乱码或非标准字符）
call :test %0.bat            :: 调用标签:test定义的子程序，并传递当前脚本文件名作为参数
cd /d %*                     :: 切换到命令行传入的目录（/d 参数允许跨驱动器切换）
:test                        :: 子程序标签定义
if "%~$PATH:1"=="" path=%~dp0;%path%  :: 如果第一个参数不在PATH中，则将其所在目录添加到PATH环境变量前
goto :eof                    :: 跳转到文件末尾（结束子程序）

@echo off
:: 功能：关闭命令行回显，使脚本运行更整洁
:: 说明：@符号作用于单行，echo off作用于后续所有行

call :test %0.bat
:: 功能：调用脚本内的test子程序
:: 参数：%0代表脚本自身文件名
:: 注意：call命令确保子程序执行后能正确返回

cd /d %*
:: 功能：切换工作目录
:: 参数：/d 允许跨驱动器切换
:: 参数：%* 表示所有传入参数（此处作为目标目录路径）

:test
:: 功能：定义子程序标签（类似函数入口）
:: 注意：标签行本身不执行任何操作

if "%~$PATH:1"=="" path=%~dp0;%path%
:: 功能：检查第一个参数是否在PATH环境变量中
:: 结构：%~$PATH:1 搜索PATH中的第一个参数
:: 操作：若不在PATH中，则将脚本所在目录(%~dp0)添加到PATH前部

goto :eof
:: 功能：跳转到文件末尾（End Of File）
:: 注意：在子程序中用于返回，主程序中会直接退出脚本

flowchart TD
    A[脚本开始] --> B[@echo off<br>关闭命令回显]
    B --> C[call :test %0.bat<br>调用test子程序]
    C --> D[执行test子程序]
    
    subgraph D [test子程序逻辑]
        D1[检查第一个参数<br>是否在PATH中] --> D2{参数在PATH中?}
        D2 -- 否 --> D3[将脚本目录<br>添加到PATH前部]
        D2 -- 是 --> D4[保持PATH不变]
    end
    
    D --> E[cd /d %*<br>切换到目标目录]
    E --> F[脚本结束]

:: 检查目录是否存在再切换
if exist "%1\" (
    cd /d "%1"
) else (
    echo 目录不存在: %1
    exit /b 1
)

:: 使用pushd/popd保存和恢复目录
pushd "%1"
rem 在此执行操作...
popd

:: 临时添加PATH（仅当前会话有效）
set "OLDPATH=%PATH%"
set "PATH=%PATH%;C:\MyTools"

:: 永久修改PATH（需管理员权限）
setx PATH "%PATH%;C:\MyTools"

@echo off
:: smart_cd.bat - 智能目录切换脚本
:: 支持目录别名、历史记录、模糊匹配

setlocal enabledelayedexpansion

:: 定义目录别名
if "%1"=="work" set "TARGET=D:\Projects\Current"
if "%1"=="docs" set "TARGET=%USERPROFILE%\Documents"
if "%1"=="temp" set "TARGET=%TEMP%"

:: 如果参数是路径，直接使用
if exist "%1\" set "TARGET=%1"

:: 执行切换
if defined TARGET (
    cd /d "!TARGET!"
    echo 已切换到: !TARGET!
) else (
    echo 无效的目录或别名: %1
)

endlocal

@echo off
:: init_project.bat - 项目环境初始化

:: 记录脚本开始时间
set "START_TIME=%time%"

:: 创建项目目录结构
for %%d in (src, bin, docs, tests, logs) do (
    if not exist "%%d" mkdir "%%d"
)

:: 设置项目特定PATH
set "PROJECT_PATH=%CD%\bin"
set "PATH=%PROJECT_PATH%;%PATH%"

:: 创建环境配置文件
echo # 项目环境配置 > .env
echo PROJECT_ROOT=%CD% >> .env
echo BUILD_DATE=%date% %time% >> .env

:: 显示执行信息
echo 项目初始化完成
echo 开始时间: %START_TIME%
echo 结束时间: %time%