链接不跳转是因锚点id生成规则不匹配；需将markdown.extension.toc.slugifymode设为github，检查标题无不可见字符及末尾标点，手动复制链接验证href是否与实际锚点一致。
Markdown All in One 自动生成目录时链接不跳转
目录生成后点击标题没反应，基本是锚点 ID 生成规则和实际标题不匹配导致的。VSCode 默认用 markdown.extension.toc.slugifyMode 控制标题转 ID 的方式，github 模式（默认）会把中文、空格、标点全转成连字符，但有些插件或预览器用的是 gitlab 或 vim 模式，ID 格式不同，链接就断了。
实操建议：
- 打开设置搜索
markdown.extension.toc.slugifyMode，确认值为github - 检查标题是否含不可见 Unicode 字符（比如全角空格、零宽空格），这类字符会导致 slugify 失败，ID 为空或异常
- 避免在标题末尾加
：、？等符号——github模式会直接删掉它们，但预览器可能保留，造成 ID 不一致 - 手动验证：右键标题 → “Copy Link Address”，看生成的 href 是否与实际锚点匹配（如
#安装步骤对应<h2 id="安装步骤">安装步骤</h2>）
sftp 插件 uploadOnSave 失效或同步延迟
按 Ctrl+S 后文件没立刻传到服务器，常见原因是 uploadOnSave 只监听保存事件，不处理临时文件、未保存缓冲区或编辑器自动保存触发的写入。
实操建议：
- 确保配置中
uploadOnSave设为true，且remotePath是绝对路径（如/var/www/html/，不是./public） - 禁用 VSCode 的“Files: Auto Save”设为
off或afterDelay，否则可能在 sftp 尚未响应前就再次触发保存，导致冲突 - 检查
ignore列表是否误写了通配符，例如**/*.log会匹配所有子目录下的 log 文件，但若写成**.log，则可能意外忽略dist/app.log以外的路径 - 调试时打开 sftp 插件输出面板（Ctrl+Shift+P → “SFTP: Toggle Output Panel”），查看实时日志里是否有
ENOTDIR或EACCES报错
Dev Containers 挂载后容器内文件修改不回写到主机
双向同步失效，通常不是挂载本身问题，而是容器内进程以非 root 用户身份写入，而主机挂载点权限不足，导致写入失败却无提示。
实操建议：
- 在
devcontainer.json中显式指定"remoteUser": "vscode"，并确保该用户对挂载目标目录有读写权限 - 挂载时加
"consistency": "cached"（macOS）或"consistency": "delegated"（Linux），避免 Docker for Mac 的文件系统缓存干扰 - 不要依赖
postCreateCommand创建的文件——它在容器启动时执行，此时挂载尚未完成，生成的文件可能落在容器本地而非挂载路径 - 验证方式：在容器终端执行
touch /workspaces/my-project/test.txt，然后在主机对应目录检查是否存在；反之亦然
Settings Sync 同步扩展列表但插件不自动启用
新设备登录后扩展已安装，但状态显示“已禁用”或功能不生效，根本原因是 VSCode 不同步插件启用状态，只同步安装记录。
实操建议：
- 同步后手动打开扩展视图（Ctrl+Shift+X），筛选出“Disabled”状态的插件，逐个启用
- 某些插件（如
Remote - SSH）需额外授权或配置才能激活，仅安装不等于可用 - 检查
extensions.autoUpdate是否为true，否则旧版本插件即使同步了也不会升级，可能因 API 变更导致功能异常 - 如果插件依赖工作区级设置（如
settings.json中的editor.codeActionsOnSave），这些设置必须也在同步范围内，否则插件行为不一致
实际使用中，最常被忽略的是 插件间协同边界：Markdown 目录插件不管预览器怎么渲染，sftp 不管你用什么 shell 编辑，Dev Containers 也不管你主机上装没装 Docker CLI。每个环节只负责自己那块协议和约定，一旦链路中某环用了非标准实现（比如自定义 slugify 函数、非标准 SSH 配置、或容器里改了 /etc/passwd），整个同步或导航就会静默失败。
