autocomplete-paths插件不生效的主因是项目根目录未被正确识别，需通过“add project folder”添加整个目录而非单文件；其次需检查scope selectors是否包含source.js/source.ts、file extensions是否涵盖目标后缀（如ts、vue），并确认relative paths已启用。
Autocomplete-Paths 插件不生效的常见原因
插件装了但输入 ./ 或 ../ 没反应，大概率是项目根目录没被 Atom 正确识别。它依赖 atom.project.getPaths() 获取根路径，如果文件不是通过「File → Add Project Folder」打开的整个文件夹，而是直接双击单个文件打开，project.paths 就为空，补全自然失效。
- 务必用「Add Project Folder」添加整个项目目录，不要只打开单个文件
- 确认状态栏右下角显示了项目路径（如
my-app/），否则插件无法定位相对路径起点 - 检查插件设置里
Relative Paths是否勾选（默认开启，但有人会误关）
如何让 import 语句中的路径支持补全
默认只对 CSS 的 @import、HTML 的 src/href 补全，JS/TS 的 import 需手动启用语法支持。Atom 把 JS 文件识别为 source.js 作用域，而插件默认未将其加入补全范围。
- 打开插件设置 → 找到
Scope Selectors输入框 - 追加
source.js和source.ts（TypeScript 项目需要） - 已有值通常是
text.html, source.css，改成：text.html, source.css, source.js, source.ts - 重启编辑器或重载窗口（
Ctrl+Shift+P→Window: Reload）才生效
补全结果不包含 .ts 或 .vue 后缀怎么办
插件默认只匹配常见扩展名（.js、.css、.html），遇到 .ts、.vue、.svelte 等会跳过。这不是 bug，是显式过滤策略。
- 进入插件设置 → 修改
File Extensions字段 - 把
js,css,html改成js,ts,css,html,vue,svelte（逗号分隔，无空格） - 注意：加太多扩展名会拖慢扫描，尤其大项目中建议只加实际用到的
- 修改后需重新触发补全（删掉已输字符再输
./）
为什么 ../ 跳转层级总少一层
插件解析 ../ 时基于当前文件所在目录向上推，但如果当前文件本身在 symlink 目录里，Node.js 的 fs.realpathSync() 可能返回真实路径，导致计算出的父级数偏移。
- 临时验证方法：在终端运行
pwd对比 Atom 状态栏显示路径是否一致 - 若不一致，说明用了软链接，建议直接打开真实路径而非 symlink 目录
- 插件不支持配置“忽略 symlink”，这是底层 Node API 限制，非配置问题
autocomplete-paths 相关报错。
