VS Code 设置同步仅同步编辑器配置（如主题、快捷键、扩展列表），不同步 HTML 文件或项目内容；要同步 HTML 项目，需用 OneDrive、Git 或 WebDAV 等外部机制管理文件本身。
VS Code 的配置同步功能本身不感知 HTML 编辑行为，它只同步编辑器层面的设置（如主题、快捷键、插件列表），而非 HTML 文件内容或项目级配置。想让本地 HTML 项目与云端保持一致，必须明确区分「编辑器配置同步」和「项目文件同步」两件事。
VS Code Settings Sync 不同步你的 HTML 文件
Settings Sync（通过 GitHub 或 Microsoft 账户登录启用）只上传以下内容：settings.json、keybindings.json、已安装扩展 ID 列表、UI 布局状态。它不会触碰你打开的任何 HTML/CSS/JS 文件，也不会同步 .vscode/extensions.json 以外的项目配置。
- 常见错误现象：改完
index.html后在另一台电脑上打开同名项目，发现页面还是旧的 —— 这不是 Settings Sync 失效，而是你根本没同步文件本身 - 真正需要同步的是项目目录，比如
~/OneDrive/my-website/或~/GitHub/my-website/ - 如果误以为开了 Settings Sync 就等于“所有东西都自动同步”，容易漏掉 git 提交、OneDrive 路径绑定、或 WebDAV 挂载等关键动作
用 OneDrive 同步 HTML 项目时路径必须精准落在同步目录内
VS Code 打开项目的方式直接决定能否触发 OneDrive 后台同步。只要项目根目录不在 OneDrive 自动同步路径下（例如 C:\Users\Name\OneDrive\Website 或 ~/OneDrive/Projects/），保存 Ctrl+S 后文件不会上传。
- 正确做法：把整个 HTML 项目文件夹（含
index.html、style.css等）放进 OneDrive 同步目录，再用 VS Code 的File → Open Folder...选中该文件夹 - 错误做法：在桌面新建
test.html，用 VS Code 打开并保存 —— 即使开了 OneDrive，这个文件也不会被监控，因为桌面不在同步范围内 - macOS 用户注意：
~/Library/Mobile Documents/com~apple~CloudDocs/是 iCloud Drive 路径，不是 OneDrive；混用会导致文件“看似存在”但实际未同步到 Windows 设备
GitHub + VS Code 配合实现带历史版本的 HTML 同步
单纯靠云盘同步无法回溯修改记录，也无法解决多人协作冲突。用 git 管理 HTML 项目才是兼顾同步与可控性的方案。
立即学习“前端免费学习笔记（深入）”；
- 初始化：在项目根目录运行
git init，然后git add .和git commit -m "initial" - 远程关联：创建 GitHub 仓库后执行
git remote add origin https://github.com/user/repo.git - 每次保存 HTML 后，在 VS Code 内置终端运行
git add index.html && git commit -m "update homepage"，再git push - 在手机或另一台电脑上，用
git clone或 GitHub Mobile App 拉取最新版，比手动复制粘贴更可靠
最容易被忽略的一点是：HTML 文件本身没有“同步开关”，所谓同步全靠外部机制驱动。VS Code 只负责编辑和保存，是否上传、何时上传、传到哪去，取决于你是否把它放在 OneDrive 目录里、是否提交到 git、是否配置了 WebDAV 自动挂载 —— 这些动作一个都不能少，也一个都不能替。
