如何在GitLab上创建项目

快速上手

• 登录 GitLab 账户。
• 点击右上角 New project，选择 Create blank project（或 Import project 从其他平台导入）。
• 填写 Project name（项目名称）与 Project slug（项目路径，通常自动与名称一致）。
• 选择 Visibility Level：Private（仅成员）、Internal（登录用户）、Public（所有人）。
• 可选：勾选 Initialize repository with a README 以自动生成初始提交。
• 点击 Create project 完成创建。

创建后的初始化与本地推送

• 在项目的 Code 页面复制仓库地址（支持 HTTPS 或 SSH）。
• 本地初始化并关联远程：
  • 方式一（HTTPS）：

    git clone https://gitlab.example.com/namespace/project.git
    cd project
    # 编辑文件后
    git add .
    git commit -m "init"
    git push -u origin main
    

  • 方式二（SSH，需先添加 SSH 公钥 到 GitLab）：

    git clone git@gitlab.example.com:namespace/project.git
    cd project
    # 编辑文件后
    git add .
    git commit -m "init"
    git push -u origin main
    

• 若本地已有代码，可在项目根目录执行：

  git init
  git remote add origin git@gitlab.example.com:namespace/project.git
  git add .
  git commit -m "init"
  git branch -M main
  git push -u origin main
  

• 建议同时添加 .gitignore 与 README.md，便于协作与规范目录结构。

进阶设置与最佳实践

• 使用 组（Group）/子组（Subgroup） 管理多项目与权限边界，按功能模块或微服务拆分仓库，便于治理与扩展。
• 设置 保护分支（Protected Branches）：在项目 Settings → Repository → Protected Branches 中，选择 main/master，仅允许 Maintainers 合并，禁止直接推送；可启用 Merge requests only 并要求 CI 流水线通过 后再合并。
• 启用 合并请求审批（Merge Request Approvals）：在 Settings → Merge request approvals 中配置 最少审批数 与 代码所有者（Code Owners） 要求，提升代码质量。
• 规范 议题（Issues）/看板（Issue Board）/史诗（Epics） 与 迭代节奏（Iteration Cadence），形成从需求到交付的闭环。
• 命名与可见性：项目名避免中文，内部项目优先 Private；为仓库配置 .gitignore 与清晰的 README 文档。

自动化创建与常见问题

• 通过 API 创建项目（示例）：

  curl --request POST \
    --header "PRIVATE-TOKEN: <your_access_token>" \
    --data "name=my-project" \
    --data "visibility=private" \
    "https://gitlab.example.com/api/v4/projects"
  

  将 <your_access_token> 替换为你的 Personal Access Token。
• 常见问题排查：
  • 推送被拒绝或提示无权限：检查是否使用 SSH 并已将公钥添加到 GitLab，或改用 HTTPS 并提供凭据。
  • 分支受保护无法推送：按上文配置 Protected Branches，通过 Merge Request 提交变更。
  • 导入项目失败：确认来源仓库可访问且权限充足，必要时使用 Personal Access Token 进行认证。