1. path-intellisense 突然不补全先别急着重装path-intellisense 是 VS Code 里专门补全文件路径的插件输入./或../时能自动列出目录和文件名写 import、require、图片引用时特别省事。它适合前端、Node、Python 项目里频繁写相对路径的人。但很多人会遇到一种情况昨天还好好的今天输入./什么都不弹重启 VS Code 没用卸载重装插件也没用。我踩过的坑是真正让 path-intellisense 失效的往往不是插件本身而是 VS Code 的全局建议设置被改掉了。比如装了 Copilot 之后觉得原生建议太吵就把editor.quickSuggestions关掉结果 path-intellisense 也跟着哑了。因为 path-intellisense 的补全依赖 VS Code 原生的 suggest 机制它自己不单独维护一套弹窗。这篇按三个角度定位settings.json 骨架配置、插件冲突、工作区设置覆盖。每一步都给可复制的配置片段和验证动作最后说明 TaoToken 统一 Key 在工具链配置里的接入位置方便你把模型通道和编辑器配置分开管理。2. 先确认 path-intellisense 依赖的三项设置path-intellisense 的补全不是独立弹窗它走的是 VS Code 的 suggest 管道。所以只要下面三项里任意一项被关插件就表现为“失效”。第一项是editor.quickSuggestions它控制打字时是否自动弹建议。很多人为了安静把它整体设为 false或者只留 comments 和 strings把 other 关掉。path-intellisense 在普通代码行触发属于 other所以 other 必须是 true。第二项是建议类型里要包含文件和文件夹。VS Code 有editor.suggest.showFiles和editor.suggest.showFolders默认是 true但有些主题或配置模板会把它关掉。第三项是editor.suggestOnTriggerCharacters输入/时是否触发建议。path-intellisense 的触发字符就是/这项为 false 时你打./不会弹。你可以打开命令面板输入Preferences: Open User Settings (JSON)先看这三项当前值。如果发现被改成 false基本就找到原因了。3. TaoToken 前置统一 Key 与 API 通道放在哪在修 path-intellisense 的同时很多人项目里还接了模型补全或 Agent 工具。这时候建议把模型通道的 Key 统一管理不要散落在各个插件配置里。TaoToken 提供统一 Key 和 API 通道接入位置在工具链的“模型服务”层和 VS Code 的路径补全设置互不干扰。你可以先到官网了解整体能力https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content需要生成或管理 Key 时进控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Key 管理页https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewriteAPI 基础地址是 https://taotoken.net/api 注意这个地址不带 UTM 参数配置时直接填。如果你只是想让模型对话验证通道是否通用模型对话页https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite长期编码或跑 Agent可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteClaude Code 相关配置参考https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-codeutm_campaignrewrite这些链接的作用是让你把模型 Key 集中在一处避免和 VS Code 的 suggest 设置混在一起排查。path-intellisense 失效和模型 Key 无关但统一管理能减少“到底哪个配置改坏了”的干扰。4. 可复制的 settings.json 骨架配置下面这段可以直接贴进用户设置或工作区设置。重点是前三项后面是 path-intellisense 自身的映射配置。{ editor.quickSuggestions: { other: true, comments: false, strings: true }, editor.suggestOnTriggerCharacters: true, editor.suggest.showFiles: true, editor.suggest.showFolders: true, editor.suggest.showWords: true, path-intellisense.extensionOnImport: true, path-intellisense.mappings: { : ${workspaceFolder}/src }, path-intellisense.autoSlashAfterDirectory: true, path-intellisense.absolutePathToWorkspace: true }逐项说明。editor.quickSuggestions.other设为 true 是 path-intellisense 能弹的基础。comments设 false 是为了减少注释里的噪音不影响路径补全。strings设 true 是因为很多路径写在字符串里比如import x from ./utils。editor.suggestOnTriggerCharacters必须 true否则输入/不触发。showFiles和showFolders控制建议列表里是否出现文件和文件夹项关掉就看不到路径候选。path-intellisense.mappings用来配别名比如指向src。如果你项目里用了 webpack 或 tsconfig 的 paths这里要同步否则插件不知道/对应哪个真实目录。autoSlashAfterDirectory设为 true 后选中目录会自动补/连续写路径更顺。absolutePathToWorkspace让补全基于工作区根目录计算多根工作区时更准。改完保存VS Code 一般会立即生效。如果没生效执行一次Developer: Reload Window。5. 验证请求与成功结果配置改完后用一个最小文件验证。新建test.js输入下面内容光标停在./后面import utils from ./正常情况下输入/的瞬间会弹出当前目录下的文件和文件夹列表。如果目录里有utils.js列表里应该出现它。选中后路径补全为./utils.js或./utils取决于extensionOnImport设置。再验证别名映射。在src下建api.js然后在文件里输入import api from /如果mappings配对了/应该弹出src下的内容。没弹的话检查mappings里的${workspaceFolder}是否被正确解析以及工作区是否真的以项目根打开。还可以用命令面板跑Path Intellisense: Show Output看插件日志里有没有报错。如果日志显示“no mappings found”就是映射没配好如果显示“suggest disabled”回到第 4 节的 quickSuggestions 检查。成功的结果是输入./弹目录输入../弹上级目录输入/弹映射目录选中后路径正确写入。三项都通过说明 path-intellisense 恢复。6. 本篇常见错排查6.1 改了用户设置但工作区设置覆盖了VS Code 的设置优先级是工作区 用户。如果你在用户设置里把editor.quickSuggestions.other设为 true但项目.vscode/settings.json里设了 false实际生效的是 false。排查时先打开工作区设置 JSON搜quickSuggestions看有没有覆盖项。{ editor.quickSuggestions: { other: false } }上面这种工作区配置会让 path-intellisense 在该项目里失效但其他项目正常。删掉或改成 true 即可。6.2 Copilot 或其他补全插件抢了 suggestCopilot、TabNine、Codeium 这类插件会接管 suggest 弹窗。有时候它们不是直接关掉原生建议而是把弹窗内容替换成自己的候选导致 path-intellisense 的路径项被挤掉。表现是弹窗还在但里面只有模型补全没有文件路径。排查方法临时禁用其他补全插件只留 path-intellisense看路径是否恢复。如果恢复说明是插件冲突。可以在设置里调整editor.suggest.showFiles的优先级或者把 path-intellisense 的触发字符单独保留。部分插件支持editor.suggest.preview关闭预览减少抢占。6.3 多根工作区导致 mappings 失效多根工作区里${workspaceFolder}可能解析成第一个根目录而不是当前文件所在根。这时候映射会指错。解决办法是用${workspaceFolder:根目录名}指定具体根或者给每个根单独配 mappings。{ path-intellisense.mappings: { : ${workspaceFolder:my-app}/src } }另外如果项目用了 tsconfig 的baseUrlpath-intellisense 不会自动读取需要手动在 mappings 里同步。否则 TypeScript 能识别的路径插件不认。6.4 文件类型未关联导致不触发path-intellisense 默认对多种语言生效但如果你打开的是纯文本文件或者文件语言模式被识别成plaintext补全不会触发。看 VS Code 右下角语言标识点一下改成 JavaScript、TypeScript、Python 等对应语言。也可以在设置里加files.associations把特定后缀关联到正确语言。6.5 设置写错层级导致整段失效editor.quickSuggestions是对象不是布尔值。如果你写成{ editor.quickSuggestions: true }VS Code 会报配置无效可能导致整个设置文件的部分项不生效。正确写法是对象形式至少包含 other。同样editor.suggest.showFiles是布尔值不要写成对象。改完看设置文件有没有黄色波浪线有就说明类型错了。7. 把模型通道和编辑器配置分开管理path-intellisense 的修复核心就一句话它依赖 VS Code 原生 suggest三项设置缺一不可。排查顺序是用户设置、工作区覆盖、插件冲突、多根映射、文件语言。按这个顺序走基本能定位。模型通道那边建议把 Key 统一放在 TaoToken 管理不要和 VS Code 的 suggest 配置混在一个文件里排查。需要验证通道时用模型对话页发一条消息需要长期编码或 Agent看 Coding Plan接入细节查文档。这样编辑器配置和模型配置各管各的出问题能快速分清是哪一层。最后提醒一句改 settings.json 前先备份或者用 Git 管理.vscode目录。配置这东西改对了没感觉改错了能查半天。