VSCode宏脚本无法直接跨设备同步，必须通过Git+软链接实现：将macros定义抽离为独立JSON或JS文件，用软链接指向，并在settings.json中引用路径；直接复制settings.json易因路径、插件、上下文差异导致静默失败。
VSCode宏脚本不能直接跨设备同步，必须走 Git + 软链接
VSCode 原生不支持宏脚本（即 macros 插件定义的 JSON 队列）自动同步。你改了 settings.json 里的 "macros" 字段，换台电脑就失效——因为那只是本地配置，不是独立文件。
真正能共享的方式只有一种：把宏定义从 settings.json 中抽出来，单独存为 JSON 文件，再用软链接指向它。这样既能版本控制，又避免污染全局配置。
- 新建文件
~/dev/vscode-macros/format-and-clean.json，内容为：{ "formatAndClean": ["editor.action.formatDocument", "editor.action.trimTrailingWhitespace", "workbench.action.files.save"] } - 在
settings.json中删掉原"macros"字段，改为："macros": { "formatAndClean": ["file:///Users/you/dev/vscode-macros/format-and-clean.json"] } - macOS/Linux 执行：
ln -sf ~/dev/vscode-macros ~/.config/Code/User/macros；Windows 用mklink /J或 PowerShellNew-Item -ItemType Junction
为什么不能直接复制 settings.json 共享宏
直接把整个 settings.json 发给同事，90% 情况下会出问题。路径、扩展 ID、本地命令 ID（比如自定义任务名）在不同机器上可能不存在或不一致，导致宏执行时静默失败或报错 command 'xxx' not found。
更隐蔽的问题是：某些宏依赖上下文，比如 editor.action.commentLine 在未打开编辑器时不可用，但 settings.json 里无法声明条件执行逻辑。
- 绝对路径写死在 JSON 里（如
"shellCommand.execute": "/usr/local/bin/prettier"）→ 切换 macOS/Windows 立刻挂掉 - 用了第三方插件命令（如
errorlens.showNextError），但协作者没装该插件 → 宏卡在第二步，无提示 -
settings.json还混着主题、字体等个人偏好 → 团队同步后反而覆盖掉关键工作区设置
vscode-macros（JavaScript 版）宏怎么共享
如果你用的是 damolinx/vscode-macros 这类支持 JS/TS 脚本的宏扩展，它的共享方式完全不同：脚本是独立文件，天然适合 Git 管理。
关键点在于路径和加载时机——VS Code 不会自动扫描子目录，所有宏脚本必须放在一个明确声明的根目录下，并通过 settings.json 显式指定。
- 建目录
~/dev/vscode-macros-js/，放insertTimestamp.ts和debugLog.js - 在
settings.json中加："vscode-macros.macrosDir": "/Users/you/dev/vscode-macros-js"
- 团队成员 clone 后只需改一行路径，再重启 VS Code；脚本内可安全调用
vscode.window.activeTextEditor等 API - 注意：TS 文件需先编译为 JS，或安装
typescript并确保vscode-macros支持 TS 加载（v2.0+ 默认支持）
共享宏最易被忽略的兼容性坑
宏不是代码片段，没有语言作用域隔离。一个绑定到 Ctrl+Alt+S 的宏，不管当前打开什么文件类型都会触发——如果里面写了 "editor.action.organizeImports"，而当前是 Markdown 文件，就会报错且中断后续命令。
真正稳定的共享宏，必须自带守卫逻辑。JSON 形式的 macros 插件做不到这点，只能靠 JS 版宏手写判断。
- 检查编辑器是否存在：
if (!vscode.window.activeTextEditor) return; - 检查语言模式：
if (editor.document.languageId !== 'javascript') return; - 避免硬编码命令 ID：用
vscode.commands.executeCommand('...')包一层，捕获rejected并 log，别让单步失败阻塞整条链 - 不要在宏里调用需要用户确认的操作（如
workbench.action.files.revert），协作场景下会卡住
