根本原因是编译产物未复用、调试符号路径错位及调试协议握手延迟；需关闭Unity“Refresh Assembly Definition References”、禁用OmniSharp自动PDB下载、在launch.json中显式配置symbolSearchPaths指向Library/ScriptAssemblies/，并确保Unity先Play再切Debug Mode。
VSCode调试Unity C#脚本卡顿、断点跳转慢、修改后重新附加耗时——根本原因不是硬件或网络，而是编译产物未复用、调试符号加载路径错位、以及Unity与VSCode之间调试协议握手延迟。优化核心在三处：禁用冗余编译、强制复用Assembly-CSharp.dll、绕过OmniSharp的PDB重解析。
Unity生成.csproj时关闭“Refresh Assembly Definition References”
默认勾选该选项会导致每次Open C# Project都触发完整重编译，哪怕只改了一个Debug.Log，也会清空Library/ScriptAssemblies/并重建所有DLL。这不是必须的——Unity 2022.3+已支持增量编译，但此选项会强行绕过它。
- Edit → Preferences → External Tools → 取消勾选
Refresh Assembly Definition References - 保留
Generate .csproj files for Unity projects（必须开启） - 后续仅需在Unity中执行
Assets → Open C# Project，不会触发全量编译
VSCode中禁用OmniSharp自动PDB下载
OmniSharp默认尝试从符号服务器下载PDB文件，但Unity的Assembly-CSharp.pdb始终在本地Library/ScriptAssemblies/目录下。远程请求失败后才 fallback 到本地，白白浪费1–3秒。
- 打开VSCode设置（
Ctrl+,），搜索omnisharp.useGlobalMono，设为always（macOS/Linux）或填入Mono路径（Windows） - 清空
omnisharp.path字段（留空，否则强制走dotnet导致符号加载失败） - 在
.vscode/settings.json中添加："omnisharp.enableMsBuildLoadProjects": false,
"omnisharp.projectLoadTimeout": 30
launch.json配置Attach模式时指定symbolSearchPaths
VSCode默认只查bin/Debug/下的PDB，而Unity实际输出在Library/ScriptAssemblies/。不显式指定，断点命中前要等OmniSharp扫描整个工作区。
- 运行
Ctrl+Shift+P→Debug: Open launch.json→ 选择.NET Core→ 改为Attach to Unity - 在生成的配置中加入：
"symbolSearchPaths": ["${workspaceFolder}/Library/ScriptAssemblies/"] - 确保
processName设为Unity（不是UnityEditor），否则可能附加到错误进程
最易被忽略的是：Unity编辑器必须先点击Play按钮启动一次（哪怕空场景），再切换到Debug Mode，最后VSCode才能成功Attach。这个“预热”步骤缺失，会导致断点灰化且无任何报错提示——它根本没连上调试端口。
