Rust Glancer 怎么安装？

Rust Glancer 的安装比想象中简单：一条组件命令 + 一个 VS Code 扩展就能跑起来。但有几个关键细节直接影响成败——rust-src 组件没装会导致项目无法正常工作，rust-analyzer 没禁用会白白多跑一个 LSP，排错时要知道去哪里看日志。

本文给出一套完整的安装配置流程，覆盖前置准备、市场直装、源码构建 VSIX、rust-analyzer 切换建议、其他编辑器的接入思路和常见问题排查。配套的背景介绍和 rust-analyzer 对比分析见站内评测《Rust Glancer 是什么：比 rust-analyzer 省 100 倍内存的 Rust LSP 评测与上手指南》。

前置条件：先装 rust-src 组件

官方文档明确：rust-src 是 Rust Glancer 正常工作的必要组件。不管你用哪种方式安装，先在终端确认它存在：

rustup component add rust-src

如果你不确定装没装过，直接执行这条命令也没问题——已安装时 rustup 会提示 already installed，不会重复安装。

除此之外的前提：

• 本机已安装 Rust 工具链（rustup）；
• 使用 VS Code 作为编辑器（官方主要适配目标）；
• 你的项目最好不依赖 proc macros（Rust Glancer 暂不支持，这是当前最大的功能缺口）。

方式一：VS Code 市场直装（推荐大多数人）

官方扩展已经上架 VS Code Marketplace，这是最快的路径：

1. 打开 VS Code，进入扩展面板（快捷键 Cmd/Ctrl+Shift+X）；
2. 搜索 Rust Glancer，认准发布者为 rust-glancer；
3. 点击 Install 安装；
4. 重启 VS Code，打开一个 Rust 项目，等待首次索引完成。

首次索引是全量急切索引，期间内存会比平时高一些，这是正常现象——索引完成后数据落盘，内存会降回 100MB 以内的稳态。后续只要代码没改，重启编辑器都不需要重新索引。

也可以直接访问官方扩展页面安装：https://marketplace.visualstudio.com/items?itemName=rust-glancer.rust-glancer

安全提示：作者本人在文档里提到，考虑到 VS Code 扩展近年频繁成为攻击目标，如果你对供应链安全要求高，建议用方式二从源码构建，或者至少关闭扩展的自动更新。这是新上架扩展（发布数天）常见的谨慎建议，供参考。

方式二：从源码构建 VSIX

适合想跟进最新代码、或对市场扩展有安全顾虑的用户：

# 1.（可选但推荐）安装 just 命令执行器
cargo install just

# 2. 克隆仓库
git clone https://github.com/rust-glancer/rust-glancer.git
cd rust-glancer

# 3. 打包 VSIX
just package-vsix

不想装 just 的话，也可以进入 editors/code 目录用 npm 手动构建。构建完成后：

1. 打开 VS Code，进入扩展面板；
2. 点击面板右上角的 ... 菜单；
3. 选择 Install from VSIX...；
4. 选中刚才生成的 VSIX 文件安装即可。

关键配置：禁用 rust-analyzer

这是新手最容易漏掉的一步。官方文档的原话是：装 Rust Glancer 时别忘了关掉 rust-analyzer。

两者同时运行技术上不冲突（作者实测过），但同时跑两个 Rust LSP 没有意义——内存省不下来，补全和诊断还可能互相"打架"。

操作方法：

1. 扩展面板搜索 rust-analyzer；
2. 点击齿轮，选择 Disable (Workspace)（只对当前工作区禁用）或 Disable（全局禁用）；
3. 重新加载窗口。

如果以后想切回 rust-analyzer，反向操作即可：禁用 Rust Glancer、启用 rust-analyzer。两个扩展的配置互不干扰，切换成本很低，完全可以按项目选择用哪个。

其他编辑器能用吗？

官方目前的答案是：VS Code 是主要编辑器，其他原生支持 LSP 的编辑器理论上可用，官方文档建议参考 rust-analyzer 提供的编辑器接入说明来手动配置，并表示"未来会支持更多编辑器"。

需要如实说明的现状：

• Neovim / Helix 等原生 LSP 编辑器：LSP 是标准协议，把语言服务器命令指向 Rust Glancer 的二进制理论上就能工作，但目前没有官方配置文档，属于进阶玩法，遇到问题需要自己排查（Rust Glancer 还不是完整 LSP，个别能力缺失会体现为对应功能不可用）；
• JetBrains 系（IntelliJ IDEA、RustRover）：不适用。JetBrains 使用自己的分析引擎而非 LSP 协议，Rust Glancer 接不进去。

在官方支持落地之前，非 VS Code 用户建议持续关注官方文档的更新：https://rust-glancer.github.io/docs/

排错：出问题先看输出通道

官方文档给了一个很实用的排错入口：Rust Glancer 的输出通道（Output Channel）。

在 VS Code 里点击底部状态栏或命令面板（Cmd/Ctrl+Shift+P）进入 Output: Show Output Channel，选择 Rust Glancer，可以看到：

• 工作区根目录（workspace root）；
• 服务器启动命令与来源（server command / server source）；
• 进程退出信息（process exit）；
• 服务器标准错误输出（server stderr）；
• 引擎启动日志（engine startup logs）。

常见问题对照：

• 扩展装了但没有任何反应：先确认 rust-src 组件已安装，再确认打开的是 Cargo 项目（工作区里有 Cargo.toml）；
• 内存没有想象中低：确认当前是不是处于首次索引阶段，索引完成后稳态内存才会降下来；同时确认 rust-analyzer 已禁用，避免误把两个 LSP 的内存加在一起看；
• 某些补全/跳转不工作：大概率命中当前已知限制（proc macros 不支持、部分类型推断场景缺失），可以去 GitHub 仓库的 issue 区搜索或反馈；
• 怀疑扩展异常：重启 VS Code 后索引应秒级恢复，如果每次重启都重新索引，说明索引数据没有被正确落盘，值得提个 issue。

给新项目的通用建议：第一次试用时，拿一个中小规模、不依赖 proc macros 的项目先跑通，建立对它响应速度和功能覆盖的预期，再决定要不要在主力项目上长期使用。

相关阅读

• 站内评测：Rust Glancer 是什么：比 rust-analyzer 省 100 倍内存的 Rust LSP 评测与上手指南——工作原理、rust-analyzer 对比与社区反响
• 官方安装文档：https://rust-glancer.github.io/docs/usage/INSTALL.html
• 官方配置文档：https://rust-glancer.github.io/docs/usage/CONFIGURE.html
• 官方限制说明：https://rust-glancer.github.io/docs/usage/LIMITATIONS.html
• VS Code 扩展页面：https://marketplace.visualstudio.com/items?itemName=rust-glancer.rust-glancer
• 站内指南：Codex Skill 怎么安装：目录结构、GitHub 下载与不生效排查
• 站内指南：Claude Code Skill 怎么安装 Skill：从 GitHub 下载、启用到更新排错

本文信息截至 2026 年 8 月 22 日，基于 Rust Glancer 官方安装文档整理。项目迭代很快，安装方式如有变化请以官方文档为准。