Path Intellisense插件默认不识别@/路径，因其不读取jsconfig.json/tsconfig.json的paths映射或构建工具alias；需手动在settings.json中配置"path-intellisense.mappings": {"@": "${workspaceFolder}/src"}，并确保src目录存在且大小写准确，最后重启窗口或语言服务器。
Path Intellisense 插件为什么补全不了 @/ 开头的路径
它根本不管 @/ 是什么，只按文件系统结构列目录。插件默认不读 jsconfig.json 或 tsconfig.json 里的 paths 映射，也不理解 Webpack/Vite 的 resolve.alias。
要让它识别 @/，必须手动配置映射：
- 在工作区
.vscode/settings.json中加："path-intellisense.mappings": {"@": "${workspaceFolder}/src"} -
${workspaceFolder}比${workspaceRoot}更可靠，尤其在多根工作区下 - 确保
src目录真实存在，且大小写完全一致（Linux/macOS 下路径区分大小写） - 改完保存后，重启 VS Code 窗口或执行
Developer: Restart Language Server
Markdown 图片路径自动补全失效的常见卡点
装了 Path Intellisense 和 Markdown All in One 却不提示图片？大概率是路径过滤没开或当前文件不在预览上下文中。
检查这几项：
-
"path-intellisense.extensions"必须显式声明支持的图片类型，例如：[".png", ".jpg", ".svg"] - 补全只在
想让运行按钮也按当前文件目录执行，有两个选择：
- 用
Code Runner插件：在用户或工作区settings.json中设"code-runner.runInTerminal": true和"code-runner.preserveFocus": false，再加"code-runner.cwd": "${fileDirname}" - 改代码更稳妥：
import os; os.chdir(os.path.dirname(__file__))放在脚本开头，绕过所有 IDE 差异 - 注意
launch.json里的"cwd": "${fileDirname}"对python -m方式有兼容性问题，建议搭配"module": "runpy"使用
路径别名在不同场景下解析不一致的根本原因
不是插件不给力，是每个工具链自己维护一套路径解析器：VS Code 语言服务读 jsconfig.json，ESLint 依赖 eslint-import-resolver-typescript，Vite 用自身 resolve.alias，三者互不通信。
所以你会遇到：
- 编辑器里
import "@/utils"不报错、能跳转，但 ESLint 提示import/no-unresolved - 本地预览图片正常，导出为 HTML 后路径变成
file:///assets/img.png而不是相对路径 -
markdown-variables插件定义的$img别名，只在 Markdown 渲染时替换，不参与 Git 提交或静态站点生成
真正统一路径行为，得靠项目级约定：要么全用 tsconfig.json（连 JS 项目也建一个），要么在构建脚本里做路径标准化处理 —— 没有银弹，只有取舍。
