autocomplete-paths 已归档且不兼容 atom 1.60+,无法识别 jsconfig.json/tsconfig.json 的 paths 别名和 esm exports,推荐改用 autocomplete-modules 插件,并需正确配置启用 require 补全及项目根目录。

Atom 里路径补全不能靠 autocomplete-plus 自带功能,必须装专用插件,且 autocomplete-paths 已失效多年,现在得用 autocomplete-modules 或 atom-ide-ui + ide-typescript(JS/TS 项目)。
为什么 autocomplete-paths 不再可用
该插件早在 2021 年被归档,不兼容 Atom 1.60+;启用后会报错或完全无响应。官方仓库已标记为 archived,apm 安装失败,GitHub 页面显示 “This repository has been archived by the owner.”
- 别再尝试
apm install autocomplete-paths——命令会失败或装上一个无法加载的空壳 - 即使强行从旧源拉取,它也不识别
jsconfig.json、tsconfig.json中的paths别名,更不支持 ESM 的exports字段 - 它的路径扫描逻辑基于同步
fs.readdirSync,在大型项目中极易卡住主线程
替代方案:autocomplete-modules 配置要点
这是目前最轻量、最稳定、且仍 actively maintained 的路径补全插件,专为 CommonJS 和 ES6 模块设计,但需手动开关键开关并校准项目根目录。
- 先装插件:
apm install autocomplete-modules(或 Settings → Packages → 搜索安装) - 打开插件设置页,勾选
Enable require() completion——否则require('./')根本不触发补全 - 确认
Project base directory指向含package.json的根目录;若设错,node_modules和本地src/路径都不会被扫描 - 如用
@/utils这类别名,必须同时启用Enable path alias completion,且项目下要有合法的jsconfig.json或tsconfig.json - 补全只响应字面量:支持
import './和require('./,但不支持import(x)或require(someVar)
ES6 路径补全失效的排查顺序
不是插件坏了,而是解析链断在某个环节。按此顺序检查比重装快得多:
- 运行
npm ls lodash(把lodash换成你要补全的包名)——若报ENOENT,说明包没装,补全自然为空 - 检查
node_modules/lodash/package.json是否有main或exports字段;缺失则视为“不可解析模块”,不会出现在候选列表 - 输入路径时必须以
./、../或/开头;直接输utils不会触发本地路径补全 - Windows 下注意大小写:文件系统不敏感,但补全列表渲染的是真实大小写——
Utils.js存在时,输utils.js能加载,但补全项只显示Utils.js - 确保右下角 grammar 是
JavaScript,不是JavaScript (JSX)或Babel JavaScript;后者 scope 不匹配,插件不响应
真正容易被忽略的是 Project base directory 设置和 Enable require() completion 开关——90% 的“补全不弹”问题都卡在这两处,而不是插件选错或 Node 版本问题。











