如何通过Azure DevOps CLI创建含指定选项的拉取请求（PR）？

前置准备 #

• 先安装Azure DevOps CLI扩展：az extension add --name azure-devops
• 登录并设置默认组织/项目：

  az login
  az devops configure --defaults organization=https://dev.azure.com/你的组织名 project=你的项目名
  

基础拉取请求创建命令 #

最核心的命令结构是从源分支向目标分支发起PR：

az repos pr create --source-branch <源分支名> --target-branch <目标分支名>

配置各项核心选项 #

1. 指定标题和描述 #

用--title定义PR标题，--description支持Markdown格式的详细说明：

az repos pr create --source-branch feature/user-manage --target-branch main \
  --title "新增用户管理功能模块" \
  --description "### 变更内容\n- 实现用户列表查询接口\n- 添加用户创建/编辑表单\n- 修复登录页自适应bug"

2. 添加审阅者 #

• 单个/多个个人审阅者：用--reviewers参数，用户名或邮箱用逗号分隔

  az repos pr create --source-branch feature/user-manage --target-branch main \
    --title "新增用户管理功能模块" \
    --reviewers alice,bob@contoso.com
  

• 添加团队作为审阅者：用--team-reviewers参数指定团队名称

  az repos pr create --source-branch feature/user-manage --target-branch main \
    --title "新增用户管理功能模块" \
    --team-reviewers "后端开发团队"
  

3. 关联工作项 #

用--work-items参数指定工作项ID，多个ID用逗号分隔：

az repos pr create --source-branch feature/user-manage --target-branch main \
  --title "新增用户管理功能模块" \
  --work-items 1234,5678

4. 其他实用选项 #

• 标记为草稿：--draft，适合未完成的PR，不会自动通知审阅者

  az repos pr create --source-branch feature/user-manage --target-branch main \
    --title "新增用户管理功能模块（草稿）" \
    --draft
  

• 自动完成PR：--auto-complete，满足所有合并条件后自动合并分支

  az repos pr create --source-branch feature/user-manage --target-branch main \
    --title "新增用户管理功能模块" \
    --auto-complete
  

• 合并后删除源分支：--delete-source-branch，避免分支冗余

  az repos pr create --source-branch feature/user-manage --target-branch main \
    --title "新增用户管理功能模块" \
    --delete-source-branch
  

组合所有选项示例 #

把常用配置整合到一条命令的完整示例：

az repos pr create --source-branch feature/user-manage --target-branch main \
  --title "新增用户管理功能模块" \
  --description "### 变更内容\n- 实现用户CRUD接口\n- 适配移动端响应式布局\n- 关联工作项#1234、#5678" \
  --reviewers alice,bob \
  --team-reviewers "后端开发团队" \
  --work-items 1234,5678 \
  --draft \
  --delete-source-branch

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