vscode中找不到unityengine命名空间，根本原因是c#扩展未切换至unity模式，需将omnisharp.useglobalmono设为always（macos/linux）或指定monopath（windows），并启用omnisharp.assetsonly、清空omnisharp.path，重启后状态栏应显示c# (unity)。
Unity项目在VSCode里找不到UnityEngine命名空间？
这是最典型的配置失败信号，根本原因不是插件没装，而是C#扩展没切到Unity模式。VSCode默认用OmniSharp走.NET SDK路径分析代码，但Unity用的是Mono/IL2CPP运行时，API元数据来源完全不同。
必须手动改两个关键设置：
-
omnisharp.useGlobalMono设为always（macOS/Linux）或指定Mono安装路径（Windows需额外装Mono并填omnisharp.monoPath） -
omnisharp.assetsOnly勾选——这会让OmniSharp跳过语言服务器启动，只读取Unity生成的.csproj引用 - 清空
omnisharp.path，任何手动填写的路径都会强制调用系统dotnet，导致加载失败
改完重启VSCode，打开任意.cs文件，右下角状态栏应显示C# (Unity)或OmniSharp: Ready (Mono)，而不是C# (LSP)。
为什么Open C# Project后还是报“无法加载项目”？
Unity生成的.csproj文件不在项目根目录，而是在Library/或Temp/下，路径含空格和特殊字符，OmniSharp默认不扫描这些位置。
解决方法不是硬改扫描路径，而是让Unity重新导出干净的项目文件：
- 在Unity中确保无编译错误，然后点击
Assets → Open C# Project - 关闭VSCode，删掉项目根目录下的
.vscode/、所有.csproj、.sln、obj/、bin/ - 回到Unity，再点一次
Assets → Open C# Project，等右下角提示Project files generated - 此时再用VSCode打开项目根目录，C#扩展才能正确定位到生成的临时项目文件
别在Unity项目根目录下执行dotnet build——它会报错或生成无关输出，Unity不用这个流程编译。
断点调试一直连不上Unity Editor？
VSCode默认生成的launch.json对Unity完全无效，因为Unity不是跑.dll的普通.NET应用，而是需要附加到正在运行的Unity进程。
必须手动配置，且顺序不能错：
- 先在Unity中点击
Play运行游戏（哪怕只是空场景） - 在VSCode中按
Ctrl+Shift+P（Win）或Cmd+Shift+P（Mac），输入Debug: Open launch.json，选.NET Core - 替换整个内容为以下配置（适配Unity 2021.3+）：
{
"version": "0.2.0",
"configurations": [
{
"name": "Unity Editor",
"type": "coreclr",
"request": "attach",
"processId": 0,
"pipeTransport": {
"pipeProgram": "bash",
"pipeArgs": ["-c"],
"debuggerPath": "/Applications/Unity/Hub/Editor/[版本号]/Unity.app/Contents/MacOS/Unity"
}
}
]
}
注意：macOS上debuggerPath要替换成你本地Unity实际路径；Windows用户需把pipeProgram改成cmd，pipeArgs改成["/c"]，debuggerPath指向Unity.exe。
装了.NET SDK但which dotnet没输出，还要装吗？
不一定。Unity项目本身不依赖dotnet命令，装SDK只是为了给C#扩展提供Roslyn分析引擎。如果VSCode右下角已显示C# (Unity)且智能提示正常，就不用强求dotnet在PATH里。
验证是否真需要：
- 打开VSCode内置终端，运行
which dotnet - 没输出？先别急着装——检查
omnisharp.useGlobalMono是否设为always，再确认Mono是否已装并加入PATH - macOS上常见问题：Mono装了但
mono --version报command not found，需手动加PATH：export PATH=$PATH:/Library/Frameworks/Mono.framework/Versions/Current/Commands
真正容易被忽略的是：Unity Tools插件虽能看日志、跳转ShaderLab，但和C#语言支持无关；C# Dev Kit插件反而会和OmniSharp冲突，必须禁用。
