{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Attach to Unity",
            "type": "vstuc",
            "request": "attach"
        },
        {
            "name": "Attach to Player",
            "type": "vstuc",
            "request": "attach",
            "endPoint": "127.0.0.1:56321"
        }
    ]
}

解决：在 Unity 中点击 Regenerate Project Files，重新打开 VS Code。新生成的 .slnx（SDK 风格解决方案）可被 C# Dev Kit 正确解析。

C# Dev Kit extension is disabled because setting 'dotnet.preferCSharpExtension' is set to 'true'

解决：在 .vscode/settings.json 中设置：

"dotnet.preferCSharpExtension": false

3. 缺少 .NET 10 Runtime

C# Dev Kit 3.x 后台服务基于 .NET 10。如果报错 You must install or update .NET to run this application，请下载安装：

• .NET 10 Runtime

• ASP.NET Core 10 Runtime（C# Dev Kit 的项目解析服务依赖它）

4. 调试 Player（真机/独立程序）

构建 Player 前，在 Unity 中勾选：

• File → Build Settings → ✅ Development Build

• ✅ Script Debugging

• （可选）✅ Wait For Managed Debugger（让 Player 启动后等待调试器连接）

四、快速检查清单

□ Unity 2022 已安装
□ VS Code 已安装 Unity 扩展（含 C# Dev Kit）
□ Unity → Edit → Preferences → External Tools → 选择 VS Code
□ Visual Studio Editor 包 ≥ 2.0.20
□ 已点击 Regenerate Project Files
□ .NET 10 Runtime + ASP.NET Core 10 Runtime 已安装
□ dotnet.preferCSharpExtension 未设为 true
□ 按 F5 启动调试

完成以上步骤后，在 VS Code 中打开 C# 脚本设置断点，回到 Unity 运行场景，即可命中断点进行单步调试。