调试和智能提示稳定需满足三点：dotnet命令可用、C#扩展显示“C# (LSP)”、launch.json中program指向正确的.dll文件；其他均为细节优化。
dotnet 命令能跑起来，C# 扩展显示 C# (LSP)，launch.json 里 program 指向正确的 .dll，这三件事全到位，调试和智能提示基本就稳了。其他都是细节补丁。
装哪个 .NET SDK 版本才不会踩坑
别跟着官网最新版乱装——dotnet --list-sdks 显示多个版本时，C# 扩展默认挑最高版，但项目里 global.json 锁的是 6.0.100，dotnet build 就会报“无法解析目标框架”。
- 新项目直接装
8.0.100（LTS，2023 年 11 月起官方主推） - 维护老项目？先查根目录有没有
global.json，看里面"version"字段，就装对应 SDK - Windows 用户禁用
dotnet-sdk-8.0.1xx-win-x64.exe这类 Web Installer，它常卡在静默下载；改用dotnet-sdk-8.0.100-win-x64.exe（离线完整包）
C# 扩展为什么总显示“找不到命名空间”
根源是它默认启用 OmniSharp 进程，而 .NET 8+ 项目必须走 dotnet CLI 调用的 LSP 模式，不是独立语言服务器。
- 打开设置（
Ctrl+,），搜omnisharp.useGlobalMono→ 设为never - 再搜
csharp.extension.autoStart→ 关掉 - 重启 VSCode，等右下角出现
.NET 8.0.100提示，且状态栏显示C# (LSP)而非OmniSharp - 如果仍不生效，检查工作区根目录是否真有
.csproj或.sln——只打开单个.cs文件，C# 扩展压根不会启动
launch.json 的 program 字段为什么老报错
program 不是指 .cs 源码，也不是 .exe，而是编译后生成的 .dll 路径。写错就直接弹出 Cannot launch program; setting 'program' must be an absolute path to the executable。
- 正确值形如：
"${workspaceFolder}/bin/Debug/net8.0/MyApp.dll" - 控制台程序加
"console": "integratedTerminal"，否则输出看不见 - ASP.NET Core 项目必须设
"env": { "ASPNETCORE_ENVIRONMENT": "Development" }，不然IConfiguration读不到appsettings.Development.json - 首次调试时 VSCode 会自动生成模板，但生成的
program可能含空格或路径错误，务必手动核对
终端里 dotnet 命令失效的真正原因
不是环境变量没配，而是 VSCode 集成终端启动时没加载 Shell 配置文件。
- macOS：确认
~/.zshrc里有export PATH="$PATH:/usr/local/share/dotnet"，然后执行Cmd+Shift+P → Developer: Restart Backend - Windows PowerShell：临时加路径用
$env:Path += ";C:\Program Files\dotnet"，但更稳的是改系统环境变量并重启 VSCode - Linux：用
sudo apt install dotnet-sdk-8.0装的，路径通常是/usr/share/dotnet；若还报错，补装libicu72和libssl3（版本号依发行版微调）
launch.json 中的 program 必须是绝对路径、指向 .dll、且该文件得真实存在——很多人调试失败，是因为没运行过 dotnet build，bin/ 目录根本是空的。
