vscode调试unity脚本必须同时满足三个硬性条件：unity生成有效.csproj文件、vscode识别为unity项目、unity编辑器运行在debug mode；缺一不可且顺序不能颠倒，否则unityengine报红、跳转失效或断点不触发。
VSCode 能调试 Unity 脚本，但必须同时满足三个硬性条件：Unity 生成了有效的 .csproj 文件、VSCode 正确识别为 Unity 项目（而非普通 .NET 项目）、Unity 编辑器运行在 Debug Mode。缺一不可，且顺序不能错。
为什么 VSCode 打开脚本后 UnityEngine 报红、跳转失效？
根本不是插件没装全，而是 VSCode 没加载到任何项目定义 —— 它连 UnityEngine.dll 在哪都不知道。
- Unity 不会自动为你生成
.csproj；双击脚本打开 VSCode ≠ 项目已加载 - 必须在 Unity 编辑器中手动执行
Assets → Open C# Project（菜单栏操作，非右键） - 确认
Edit → Preferences → External Tools → Generate .csproj files for Unity projects已勾选，否则该操作静默失败 - 生成成功后，项目根目录应出现
Assembly-CSharp.csproj和YourProjectName.sln；没有就重试 - 若仍异常，删掉
.vscode/、.sln、.csproj、obj/、bin/，重启 Unity 再执行一次Open C# Project
为什么断点设置了却完全不触发？
Unity 编辑器默认以 Release Mode 运行，剥离所有调试符号，VSCode 根本无法注入调试信息 —— 这是 90% 断点失效的真正原因。
- 检查 Unity 编辑器右下角状态栏：找到虫子图标（
Debug），点击使其高亮变蓝 - 弹出窗口中必须显示
Debug Mode，而不是Release Mode -
Edit → Preferences → External Tools → Editor Attaching在新版本中已弃用，别再依赖它 - 该模式只影响编辑器内 Play 模式，不影响构建包性能；调试完可手动切回 Release Mode 提升编辑器响应速度
VSCode 应该装哪些扩展、怎么配才不冲突？
旧版 C# 扩展（ms-dotnettools.csharp）和 C# Dev Kit（ms-dotnettools.csdevkit）会抢 OmniSharp 控制权，导致类型提示全丢。
- 卸载或禁用旧版
C#扩展，只保留C# Dev Kit和官方Unity扩展（发布者是 Unity Technologies） - 不要手动设置
omnisharp.path—— 填了反而强制走dotnet，加载失败 - 确保
omnisharp.useGlobalMono设为always（macOS/Linux）或留空（Windows 自动探测） - 重启 VSCode 后，右下角状态栏应显示
C# (Unity)或.NET SDK: 6.0.x/8.0.x（取决于 Unity 版本） - 如果显示
C# (LSP)或OmniSharp: Starting...卡住，说明项目未加载或 SDK 版本不匹配
安卓或 iOS 真机调试要额外注意什么？
真机调试不是“把本地配置复制过去”就行，端口绑定和网络可达性是关键瓶颈。
- Android：Unity 必须使用
Mono脚本后端（IL2CPP不支持托管调试）；构建时勾选Development Build+Script Debugging - Android：若日志显示
Listening for debugger on 127.0.0.1:56000，必须用adb forward tcp:56000 tcp:56000转发，不能直连 IP - iOS：需
iproxy 56000 56000命令转发 USB 端口，且launch.json中endPoint必须写127.0.0.1:56000 - 所有真机调试前，先在 Unity 日志里确认实际监听地址和端口 —— Unity 6.2+ 可能动态分配端口，不是固定 56000
最容易被忽略的是：Open C# Project 和 Debug Mode 必须都生效，且先后顺序不能颠倒。很多人反复重装插件、改 launch.json，其实只是没点那个虫子图标，或者没手动触发项目文件生成。
