vscode插件路径配置中仅${workspacefolder}和${filedirname}等少数变量有效，${projectroot}等为非法变量；markdown图片路径必须基于.md文件位置用./或../书写，不支持变量解析。
VSCode插件路径配置中哪些变量可用
VSCode 本身不直接解析 Markdown 或 Python 中的相对路径，它只在特定上下文（如 launch.json、tasks.json、插件设置）里支持有限的变量语法。真正能用的只有几个硬编码变量，不是所有“${xxx}”都有效。
常见但无效的写法：${projectRoot}、${root}、${mdFileDir} —— 这些根本不存在，VSCode 会原样保留或报错。
-
${workspaceFolder}：唯一稳定可用的根路径变量，指向你打开的文件夹（即工作区根目录） -
${fileDirname}：当前编辑文件所在目录，仅在调试/任务配置中生效，不能用于 Markdown 图片路径 -
${fileBasenameNoExtension}：仅限调试参数传递，和路径无关
别指望用变量拼接出动态图片路径——Markdown 预览器不认这些，它只按标准文件系统规则解析 ./、../。
Markdown 图片路径必须以 .md 文件为基准计算
VSCode 的 Markdown 预览器把  中的 path 当作相对于当前 .md 文件所在目录的路径。不是相对于项目根目录，也不是相对于 assets 目录。
典型错误现象：docs/guide.md 里写 ，但图片实际在 assets/images/logo.png，结果预览空白。
- 正确写法（假设
guide.md和assets同级）： - 如果
guide.md在docs/下，而assets/在项目根，则必须回退两级： - 路径中不能含空格或中文，否则部分插件补全失败，预览器也可能静默忽略
别试图用 ${workspaceFolder}/assets/... —— Markdown 解析器根本不处理这种语法。
Path Intellisense 插件的路径补全依赖真实文件结构
插件不会“猜”路径，它只扫描磁盘上真实存在的文件，并基于当前光标位置自动推导合法相对路径。启用后按 Ctrl + Space 触发补全，前提是：
- 插件已安装且启用（检查状态栏右下角是否有 Path Intellisense 图标）
-
"path-intellisense.extensions"设置包含目标类型，例如：[".png", ".jpg", ".svg"] - 你输入的是
后把光标挪进括号里再触发 - 目标文件确实存在于磁盘上，且路径可被 VSCode 访问（比如没被
.gitignore或权限拦截）
如果补全列表为空，先确认图片文件是否真在对应目录下，而不是靠记忆或旧文档推测。
launch.json 中 cwd 设置只对调试生效
很多人以为改了 launch.json 里的 "cwd": "${fileDirname}" 就能让所有路径行为一致，其实它只影响 F5 调试启动的 Python 进程。终端里直接运行 python script.py、Code Runner 插件点击运行、甚至右上角 ▶️ 按钮，都完全无视这个配置。
- 调试时生效：
os.getcwd()返回script.py所在目录 - 终端手动运行时：
os.getcwd()是你当前终端所在路径，和 VSCode 无关 - Code Runner 默认 cwd 是
${workspaceFolder}，需在设置里改code-runner.cwd为${fileDirname}
跨场景一致性的唯一可靠方式，是代码里用 os.path.dirname(__file__) 构建路径 —— 这个不依赖任何 IDE 配置，也不怕迁移。
