针对Unity开发者：Sublime编写C#脚本的代码提示环境

Sublime Text 3 要做到对 Unity C# 有靠谱的代码提示，前提是 OmniSharp 成功加载了 UnityEngine.dll 等核心程序集，并且运行在匹配的 .NET 运行时上。如果这个前提不成立，Ctrl+Space 按下去只能是空的。路径要精确指向 Managed 目录，.csproj 得由 Unity 正确生成并包含有效引用，否则补全和跳转功能都会失效。

很多开发者配完环境后发现没反应，关键就在于 OmniSharp 没能成功加载 Unity 的程序集。它不是一个全靠猜测来补全的智能工具，必须实际加载 UnityEngine.dll 才能构建符号索引。路径差一级、Mono/.NET 版本对不上、DLL 文件本身找不到（比如旧版 Unity 把它放在 Managed/UnityEngine/ 子目录），都会导致失败。

OmniSharp 启动后没补全？先查 omnisharp.log 里有没有 Could not load file or assembly 'UnityEngine'

这是最常见的故障信号。排查时，重点检查以下三点：

• Windows 用户：检查 OmniSharp.sublime-settings 中 "use_global_mono" 是否设为 "auto" 或明确指向已安装的 Mono。如果用 .NET SDK，则需手动设置 "omnisharp_server_path" 指向 OmniSharp.exe。
• macOS/Linux 用户：必须安装与 Unity Scripting Runtime Version 相匹配的 .NET SDK（不是 runtime），执行 dotnet --list-sdks 确认版本存在。例如 Unity 2021.3.30f1 对应 .NET 5.0，而 Unity 2022.3.20f1 要求 .NET 6.0。
• DLL 路径必须精确到 Managed 目录层级：Windows 下是 C:\Program Files\Unity\Hub\Editor\2021.3.30f1\Editor\Data\Managed，macOS 下是 ~/Unity/Hub/Editor/2021.3.30f1/Editor/Data/Managed/。路径既不能只填到 Data，也不能漏掉末尾的 Managed。

Ctrl+Click 跳转不到 Input 或 Transform？确认 .csproj 是 Unity 主动生成的

Sublime 自身并不会解析项目结构，OmniSharp 完全依赖 .csproj 文件里的 和 节点来判断“哪些脚本属于本项目”以及“引用了哪些 DLL”。直接在 Sublime 里双击脚本是无效的，这不会触发工程同步。正确的做法是：

• 在 Unity 编辑器中执行 Assets → Open C# Project（不是右键 Open with…），这会强制重写所有 .csproj 和 .sln。
• 检查 .csproj 文件是否包含类似 ...UnityEngine.dll 的条目，且 HintPath 指向你配置的 Managed 目录。
• Unity Preferences → External Tools → External Script Editor 必须设为 Sublime，并勾选 Generate all .csproj files，否则新增脚本不会被纳入工程。

补全有但不准，比如 transform.position. 只列出 x 却没有 y、z？检查 source.cs 作用域是否生效

Sublime 的语法高亮和补全行为受当前文件的 scope 控制。如果打开的 .cs 文件左下角显示的是 Plain Text 或 C++，OmniSharp 根本不会介入。

• 手动设置：点击右下角语言名，选择 Open all with current extension as... → 选 C#。
• 确保 selector 在 Build System 和 OmniSharp 配置中保持一致，例如 "selector": "source.cs"。
• 部分 Unity 插件（如旧版 SublimeCodeIntel）会干扰 OmniSharp，建议禁用非必要的 C# 相关插件，只保留 OmniSharp 和 Package Control。

从实际排查经验来看，真正卡住人的地方往往不是“怎么配置”，而是“配置完没反应时该看哪一行日志”。omnisharp.log 默认在 Sublime 的 Packages/User/OmniSharp/ 目录下，第一时间盯着 Could not load 和 Failed to resolve assembly 这两类报错——它们比任何教程都更能帮你定位问题。