如何在GitLab 16.7中借助Symbol Server调试.NET类库项目

一、修正CI/CD配置，正确上传snupkg符号包 #

你的当前配置仅上传了nupkg主包，未处理snupkg符号包。GitLab的NuGet源支持直接上传snupkg，无需指定特殊路径，只需调整deploy阶段脚本：

1. 确保生成完整符号文件
   在build阶段添加符号生成参数，保证符号格式符合snupkg要求：

   build:
     stage: build
     script:
       - 'dotnet build --configuration Release /p:DebugType=Portable'
   

   （Portable类型符号是snupkg推荐格式，兼容性更强）

2. 同时推送主包与符号包
   修改deploy阶段的push命令，同时上传两种包：

   deploy:
     stage: deploy
     script:
       - 'dotnet pack -c Release /p:PackageVersion=1.0.0-$VERSION_SUFFIX --output $NUGET_PACKAGES_DIRECTORY --version-suffix $VERSION_SUFFIX --include-symbols -p:SymbolPackageFormat=snupkg'
       - 'dotnet nuget add source "${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/nuget" --name gitlab --username gitlab-ci-token --password $CI_JOB_TOKEN --store-password-in-clear-text'
       # 推送主包
       - 'dotnet nuget push $NUGET_PACKAGES_DIRECTORY/*.nupkg --source gitlab'
       # 推送符号包
       - 'dotnet nuget push $NUGET_PACKAGES_DIRECTORY/*.snupkg --source gitlab'
     environment: production
   

   也可以用--symbol-source参数一次性推送：

   - 'dotnet nuget push $NUGET_PACKAGES_DIRECTORY/*.nupkg --source gitlab --symbol-source gitlab'
   

   GitLab会自动识别并存储snupkg符号包。

二、配置Visual Studio识别GitLab符号包 #

1. 添加GitLab NuGet源
   打开Visual Studio「工具」→「选项」→「NuGet包管理器」→「包源」，添加项目源：

   • 名称：自定义（如GitLab）
   • 源地址：https://mygitlab.com/api/v4/projects/[你的项目ID]/packages/nuget/index.json
   • 认证：勾选「需要认证」，用户名填gitlab-ci-token，密码填GitLab个人访问令牌（需具备read_api和read_repository权限）

2. 配置符号加载
   打开「工具」→「选项」→「调试」→「符号」，点击「添加」将上述GitLab源地址设为符号源，勾选「启用源服务器支持」，并指定本地符号缓存目录。

3. 调试时加载符号
   调试项目时，断点命中类库代码后，Visual Studio会自动从GitLab下载符号；若未自动加载，可右键点击调用栈中的类库方法，选择「加载符号」手动指定GitLab源。

三、额外注意事项 #

• 确保项目「包仓库」功能已启用：项目设置→通用→可见性、项目功能、权限→包仓库，设置为启用状态
• 个人访问令牌需具备足够权限：至少包含read_api和read_repository权限
• 若使用GitLab私有实例，需保证Visual Studio能正常访问实例网络，无防火墙或代理拦截

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