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 FilesUnityHubEditor2021.3.30f1EditorDataManaged，macOS 下是 ~/Unity/Hub/Editor/2021.3.30f1/Editor/Data/Managed/。路径既不能只填到 Data，也不能漏掉末尾的 Managed。

排查时优先盯日志。如果出现 Could not load 或 Failed to resolve assembly，基本就能确定问题在程序集加载环节。

Ctrl+Click 跳转不到类或成员时怎么查

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 这两类报错。

它们比任何教程都更能帮助你快速定位问题。

《夸克》非常好用的免费AI浏览器

下载APP查看