atom代码提示不全因未启用lsp:autocomplete-plus与atom-ternjs等不支持lsp协议,无法提供跳转定义、悬停文档等功能;需改用atom-ide-ui+ide-*系列插件,并正确配置对应语言服务器及项目上下文。

Atom 代码提示不全,不是插件装少了,而是语言服务器协议(LSP)支持压根没启用——autocomplete-plus 和传统 provider(如 atom-ternjs)根本不走 LSP,它们是各自解析 AST 或调用本地 CLI,没法共享类型信息、跳转定义、悬停文档这些现代 IDE 功能。
为什么 autocomplete-plus + atom-ternjs 算不上 LSP
autocomplete-plus 是纯前端补全框架,只管弹窗和排序;atom-ternjs 是基于 Tern.js 的独立服务,通过 socket 与 Atom 通信,但协议私有、无标准接口。它不提供 textDocument/definition 或 textDocument/hover 这类 LSP 方法,自然没法支持“跳转到定义”或“悬停看类型”。
- 你点一个变量按
F12没反应?不是快捷键错,是根本没注册 LSP handler - 鼠标悬停不显示函数签名?因为
atom-ternjs默认只返回字符串建议,不带documentation字段 - 改了
node_modules里的类型,提示没更新?Tern 缓存机制和 LSP 的 workspace/didChangeWatchedFiles 不兼容
Atom 怎么真正启用 LSP 支持
必须弃用 atom-ternjs / autocomplete-python 这类旧 provider,换用基于 atom-ide-ui 或 ide-* 系列插件的 LSP 客户端。它们才是官方认可的 LSP 入口。
- 先装
atom-ide-ui:它是 UI 层,提供面板、状态栏、悬浮窗等基础设施 - 再按语言装对应
ide-*插件:ide-typescript(TS/JS)、ide-python(需系统有pylsp)、ide-php(依赖php-language-server) - 关键一步:确认语言服务器二进制在 PATH 里,或在插件设置中填绝对路径,比如
ide-typescript的Typescript Server Path必须指向node_modules/typescript/lib/tsserver.js - 不要同时启用
atom-ternjs和ide-typescript:两者监听同一语法范围,会抢断textEditor事件,导致补全卡顿或空白
PHP/Python/JS 各自的 LSP 服务怎么配才不翻车
LSP 不是装完插件就自动跑起来的,每个语言的服务进程要能启动、能连上、能读项目配置,三者缺一不可。
- PHP:
ide-php依赖php-language-server,必须全局composer global require felixfbecker/language-server,且php -v≥ 7.4;否则启动失败日志里只有spawn php ENOENT - Python:
ide-python默认找pylsp,不是python-language-server(已归档),得pip install python-lsp-server[all];若项目用 Poetry,还要在插件设置里勾选Use Workspace Virtual Environment - JavaScript/TypeScript:
ide-typescript需要项目级tsconfig.json或至少有package.json,否则降级为“仅内置 API 补全”,你写的utils.ts里的函数不会出现在提示里
补全还是不全?检查这三处真实断点
很多人查了一圈插件列表,发现都启用了,还是提示少——问题往往不在 Atom 侧,而在语言服务本身是否真把符号加载进来了。
- 打开 Atom 控制台(
Cmd+Alt+I),过滤lsp,看有没有Connection closed或Failed to start server报错 - 右下角状态栏点开语言模式,确认当前文件 grammar 是
source.ts(不是source.js.jsx),否则ide-typescript根本不响应 - 在项目根目录运行
npx tsc --watch --noEmit(TS)或pylsp(Python)手动启服务,看终端是否报错;如果命令行都起不来,Atom 插件必然空转
最易被忽略的是:LSP 补全依赖完整的项目上下文初始化,不是开个文件就立刻可用。第一次打开大项目时,ide-typescript 可能要花十几秒解析 node_modules,期间只返回空列表——这不是挂了,是还在加载。










