如何在Visual Studio 2019中配置使用自建本地GitLab服务

无需依赖第三方扩展，直接使用VS2019内置的标准Git功能即可实现需求，操作步骤如下：

前置准备 #

• 先在本地部署的GitLab Web端创建对应空白仓库，复制仓库的HTTP/SSH访问地址，确保本地网络可正常访问该地址，且你的账号拥有仓库的读写权限
• 若使用HTTP协议连接，建议先在GitLab端生成个人访问令牌：进入个人设置→访问令牌页面，勾选read_repository、write_repository权限后生成保存，后续身份验证用该令牌替代账号密码，兼容性更强

现有项目关联GitLab仓库操作步骤 #

场景1：项目还未初始化本地Git仓库 #

1. 打开目标项目，点击右下角状态栏的「添加到源代码管理」按钮，选择Git，等待本地仓库初始化完成
2. 点击顶部菜单栏「Git」→「设置」，进入源代码管理的Git配置页
3. 先切换到全局设置标签，确认配置的用户名、邮箱和你GitLab账号的信息一致
4. 再切换到存储库设置标签，找到「远程」分类，点击「添加」按钮
5. 远程名称填origin，地址粘贴你提前复制的GitLab仓库地址，点击确定保存
6. 回到Git变更窗口，提交所有待变更的代码后，点击「推送」按钮即可将代码同步到私有GitLab服务器

场景2：项目已经存在本地Git仓库 #

1. 打开项目后进入「Git」→「设置」→「存储库设置」→「远程」页面
2. 找到原有origin远程地址，点击编辑，直接将地址替换为你的GitLab仓库地址后保存
3. 后续提交推送操作直接在VS内置Git面板完成即可

常见问题排查 #

• 推送时提示权限错误：打开Windows系统的「凭据管理器」→「Windows凭据」，找到对应GitLab地址的保存凭据，删除后重新推送，输入你的GitLab账号和提前生成的个人访问令牌即可
• 不需要安装GitLab Extension for Visual Studio扩展也可以完成所有基础Git操作，该扩展仅提供GitLab专属的MR创建、CI/CD状态查看等附加功能，不影响基础的代码同步能力

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