需手动安装OLS服务端并配置路径，确保项目含odin.mod、Odin≥v0.4.0且VSCode原生运行；状态栏显示“OLS: Ready”、DevTools无错误、补全跳转正常三者缺一不可。
怎么装OLS插件并让它真正工作
OLS（Odin Language Server）不是VSCode自带的，必须手动安装服务端二进制，并让插件知道它在哪。只装VSCode扩展 odin-lang.vscode-odin 是不够的——它默认会找系统 PATH 里的 ols 命令，找不到就静默失效，连报错都不显示。
实操建议：
- 去 OLS GitHub Releases 下载对应系统的预编译
ols（如ols-v0.2.0-linux-x64），解压后放到固定路径，比如~/bin/ols - 确保该路径已加入系统 PATH（macOS/Linux 检查
echo $PATH，Windows 检查环境变量），或在 VSCode 设置里手动指定："odin.languageServerPath": "/home/you/bin/ols" - 重启 VSCode，打开一个
.odin文件，看右下角状态栏是否出现 “OLS: Ready”。没出现？打开命令面板（Ctrl+Shift+P），运行Developer: Toggle Developer Tools，在 Console 里搜ols或stderr，大概率是路径错、权限不足（Linux/macOS 缺少chmod +x），或 glibc 版本太低（Ubuntu 18.04 以下常见）
为什么写完代码没提示、跳转也不行
OLS 依赖项目根目录存在 odin.mod 或 odin.sum 才能正确解析依赖和标准库路径。没有模块文件时，它会退化为“裸文件模式”，只做基础语法检查，不加载 core、shared 等内置包，自然没有函数签名、定义跳转和自动补全。
实操建议：
- 在项目根目录运行
odin init生成odin.mod（哪怕只是空项目） - 如果用子目录开发（比如
src/main.odin），VSCode 工作区必须打开整个项目根，不能只打开src文件夹——否则 OLS 启动时找不到odin.mod - 修改
odin.mod后，不需要重启 OLS，但要等几秒让它重载；如果等太久，手动执行命令Odin: Restart Language Server
编译运行按钮点不动或报错“command ‘odin.build’ not found”
VSCode 插件 odin-lang.vscode-odin 自带的运行任务依赖系统 PATH 中存在 odin 命令，且版本 ≥ v0.4.0。旧版 Odin（如 v0.3.x）没有 odin build 子命令，插件就会直接失败，界面按钮灰掉，终端也无输出。
实操建议：
- 运行
odin version确认版本，低于 v0.4.0 就升级：从 Odin 官方 Release 页面 下载新二进制，替换旧的odin - 如果不想全局升级，可在 VSCode 设置中指定 Odin 路径：
"odin.path": "/opt/odin-v0.4.0/odin" - 运行快捷键
Ctrl+F5（Windows/Linux）或Cmd+F5（macOS）触发的是插件预设的odin run任务，它默认编译并执行当前活动文件（不含扩展名）。确保当前打开的是main.odin，且内容含package main和main :: proc()
Mac 上启动 OLS 失败：dyld: Library not loaded
这是 macOS 典型的动态链接问题。OLS 预编译包依赖较新的系统库（如 libstdc++.6.dylib），而 macOS 12+ 默认不带 GCC 运行时，且 Apple Silicon（M1/M2）上 Rosetta 2 有时无法正确桥接 x86_64 的 dylib。
实操建议：
- 优先下载标记为
-darwin-arm64的 OLS 版本，而不是-darwin-amd64 - 若只有 amd64 版，且你用的是 Apple Silicon，不要用 Rosetta 打开 VSCode——必须原生运行 VSCode（检查“显示简介”里是否勾选“使用 Rosetta”）
- 实在不行，就本地编译 OLS：
git clone https://github.com/odin-lang/ols，然后用系统已有的 Odin 编译（需先装好 Odin），生成的二进制天然适配当前环境
OLS 对项目结构敏感，对 Odin 版本有硬性要求，而且错误常常静默。最常被忽略的一点是：它不报错，不代表在工作——得看状态栏文字、DevTools 控制台、以及实际有没有补全和跳转，三者缺一不可。
