VS Code跨平台配置共享需明确区分可共享项与平台特异性项：settings.json中基础设置如tabSize可直接复用，但终端配置、解释器路径、插件命令等须用变量或条件分支；launch.json/tasks.json应避免硬编码路径，优先使用${workspaceFolder}等变量；extensions.json不应提交Git，因其不含版本与平台适配信息。
VSCode 本身不运行“脚本”作为独立可执行单元，所谓“跨平台共享的 VSCode 脚本”，实际指的是三类东西：用户级配置文件（settings.json）、项目级调试/构建配置（launch.json、tasks.json、CMakeLists.txt）、以及用于环境迁移的命令行操作（如 code --list-extensions）。它们能跨平台共享的前提不是“写一次跑 everywhere”，而是**明确区分哪些内容可共享、哪些必须按平台处理、哪些绝对不能进 Git**。
settings.json 里哪些字段能直接跨平台复制？
大部分基础设置是安全的，比如 "editor.tabSize": 2、"files.autoSave": "onFocusChange"、"workbench.colorTheme": "One Dark Pro"。但以下几类必须检查或替换：
-
"terminal.integrated.profiles.*"：Windows 的"PowerShell"和 macOS/Linux 的"zsh"路径完全不同，直接复制会导致终端打不开；建议删掉该字段，让 VSCode 自动探测 -
"python.defaultInterpreterPath"：路径含C:或/opt/homebrew/等平台特有前缀，必须改为相对路径或用变量（如"${env:HOME}/.pyenv/versions/3.11/bin/python"） -
"emeraldwalk.runonsave"类插件的命令路径：若硬编码了npm.cmd或prettier绝对路径，同步后在另一系统上会报command not found - 所有含
\反斜杠的路径字段（如"cSpell.userWords"中的 Windows 路径），需统一改为正斜杠/或使用${workspaceFolder}变量
launch.json 和 tasks.json 怎么避免平台崩溃？
这类文件最容易在换系统后 F5 就报错，核心矛盾在于：调试器启动路径、工作目录、参数分隔符都依赖 OS 行为。关键处理点：
-
"program"字段不要写死绝对路径，优先用${workspaceFolder}/bin/Debug/net8.0/app.dll这类变量组合 -
"args"数组中，Windows 下用["--config", "C:\path\to\conf.json"]会失败，应拆成["--config", "${workspaceFolder}/conf.json"] -
"cwd"必须设为${workspaceFolder}或子目录，禁用C:project这类硬编码 - 涉及 shell 命令的
tasks.json（如调用make或dotnet build），把"type": "shell"改为"type": "process"，并显式指定"windows"/"linux"/"osx"分支配置
为什么 .vscode/extensions.json 不该提交到 Git？
这个文件只是记录当前已安装扩展的 ID 列表（如 ms-python.python），看似无害，但它有三个隐蔽风险：
- 它不包含版本号，
ms-python.python在不同 VSCode 版本下可能安装 v2024.x 或 v2025.x，导致团队成员行为不一致 - 某些插件（如
ms-vscode.cpptools）在 Windows/macOS/Linux 上实际安装的是不同二进制包，extensions.json无法表达这种差异 - 它容易和 Settings Sync 冲突：当你用 GitHub 账户同步时，VSCode 会忽略该文件，但 Git 提交后又会覆盖本地同步状态
- 真正该进 Git 的是
.vscode/extensions.md（手写说明）或根目录的devcontainer.json，后者能声明确定版本的插件依赖
跨平台脚本迁移最常被忽略的一件事
开发者花时间处理 JSON 配置，却忘了 keybindings.json 里的快捷键映射。例如 Ctrl+Shift+P 在 Windows/macOS 上是等效的，但 Cmd 键在 Linux 上不存在——VSCode 会自动 fallback 到 Ctrl，可一旦你写了 "key": "cmd+k cmd+i"，Linux 用户就永远触发不了。正确做法是：只用 ctrl 作为主修饰键，或用 "mac"/"linux"/"win" 条件块做分支定义。这点没有报错提示，只有某天发现快捷键失灵才意识到。
