git本身不支持分支名自动映射部署路径，需通过脚本或ci/cd工具实现：用git rev-parse --abbrev-ref head安全获取分支名，校验合法性后拼接路径（如/var/www/app-$branch），并确保本地、ci、服务器处理逻辑一致。
如何用 Git 分支名动态决定部署路径
直接结论：Git 本身不提供“根据分支自动切换部署目录”的功能，必须靠脚本或 CI/CD 工具联动实现。核心思路是读取 git rev-parse --abbrev-ref HEAD 获取当前分支名，再用它拼出目标路径。
Shell 脚本里安全提取并使用分支名
很多人直接写 $(git branch | grep '*' | awk '{print $2}')，但这种解析不可靠——比如分支名含空格、或在 Detached HEAD 状态下会失败。正确做法始终用 Git 原生命令：
-
git rev-parse --abbrev-ref HEAD返回当前分支名（main、dev），Detached HEAD 时返回HEAD - 加判断避免空值：
branch=$(git rev-parse --abbrev-ref HEAD) && [ "$branch" = "HEAD" ] && echo "detached" || echo "$branch" - 路径拼接别裸写：
deploy_dir="/var/www/app-$branch"，建议先mkdir -p "$deploy_dir"再操作，防止因路径不存在导致 rsync/cp 失败
CI/CD 中（如 GitHub Actions）怎么映射分支到目录
GitHub Actions 的 github.head_ref 在 pull_request 事件中可用，但 push 事件要用 github.head_ref || github.ref_name 才健壮。常见坑：
-
github.ref是完整 ref（如refs/heads/main），得用${{ github.ref_name }}提取分支名 - 部署前务必验证分支名是否合法：
[[ "$branch" =~ ^[a-zA-Z0-9._-]+$ ]] || exit 1，防止注入或非法路径 - 若用
rsync部署，目标路径末尾加斜杠很重要：rsync -av ./build/ "user@host:/var/www/app-$branch/"—— 少了斜杠会把整个app-$branch当作文件名覆盖
本地开发时手动部署也想自动适配目录？
可以封装一个 alias 或小脚本，但要注意权限和路径一致性：
- 别硬编码绝对路径，用
$(pwd)或项目根目录检测：cd "$(git rev-parse --show-toplevel)" - 分支名用于目录时，建议转小写 + 替换特殊字符：
safe_branch=$(echo "$branch" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9.-]/-/g') - 如果多个分支共用同一台测试机，记得清理旧目录（如保留最近 3 个分支的部署），否则磁盘迟早爆掉
真正麻烦的不是获取分支名，而是确保所有环节（本地、CI、服务器）对分支名的处理逻辑一致——尤其当分支含 /（如 feature/login-flow）时，路径层级容易错乱，得提前约定好扁平化规则。
