VSCode无通用脚本分发机制，团队共享依赖靠三类文件协同：extensions.json声明插件推荐（仅提示安装）、.vscode/snippets/存放语言专属代码片段（Git同步即用）、独立shell/PowerShell脚本由用户主动执行。
VSCode 本身不提供“通用脚本”的内置分发机制，所谓“共享脚本”实际指三类东西：用户代码片段（snippets）、插件推荐列表（extensions.json）、工作区级配置脚本（如 shell/PowerShell 初始化逻辑）。它们必须靠文件路径+版本控制+显式加载逻辑来协同生效，不能靠 VSCode 自动广播或推送。
怎么让团队成员自动装上推荐插件？用 extensions.json
这是最轻量、最可控的“脚本共享”方式——它不执行任何命令，只声明依赖。VS Code 在打开项目时会读取 .vscode/extensions.json 并提示未安装的插件。
- 在项目根目录建
.vscode/extensions.json，内容格式严格：
{
"recommendations": [
"esbenp.prettier-vscode",
"ms-python.python",
"redhat.vscode-yaml"
]
}
- 不要写成
recommends或suggestions，字段名必须是recommendations - 插件 ID 必须准确：打开插件页 → 看 URL 最后一段，例如
https://marketplace.visualstudio.com/items?itemName=ms-python.python→ ID 是ms-python.python - 该文件只触发提示，不会静默安装；用户需点击 “Install All” 或手动确认 —— 这是设计使然，无法绕过安全策略
代码片段怎么跨项目复用？走工作区级 snippets/ + Git
把片段放在 .vscode/snippets/ 下，比塞进用户目录更可靠，也避免多人编辑同一 javascript.json 导致 Git 冲突。
- 路径结构示例：
.vscode/ ├── snippets/ │ ├── javascript.json │ ├── typescriptreact.json │ └── python.json └── settings.json
-
settings.json中建议加一句："editor.snippetSuggestions": "top"，确保片段优先于其他补全项 - 每个
*.json文件只包含一种语言的片段，且body字段用数组写法（避免缩进错乱）：
"body": ["function ${1:name}() {", "\t${2:// body}", "}"]
- 提交整个
.vscode/到 Git —— 新成员克隆即得，无需额外 setup 步骤 - 注意：
.vscode/snippets/下的片段仅对当前工作区生效，不会污染用户全局配置
PowerShell / shell 初始化脚本怎么安全分发？别放进 VSCode 配置
VSCode 不执行、不托管、不校验外部脚本。所谓“初始化脚本”，本质是独立的 .ps1 或 .sh 文件，必须由用户主动调用，或集成进 CI/CD 流程。
- 常见错误：把
setup.ps1放进.vscode/目录，指望 VSCode 自动运行 —— 它不会 - 正确做法：在项目根目录放
scripts/，文档里写清楚执行条件和权限要求 - Windows 脚本必须处理执行策略：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser是最低要求，但需用户手动确认 - 脚本中所有路径用相对路径（如
./scripts/install-deps.ps1），禁用硬编码C:\Users\...—— 否则在别人机器上直接失败 - 若脚本要调用
codeCLI，请用绝对路径："C:\Program Files\Microsoft VS Code\bin\code.cmd"，避开 User Installer 和 PATH 冲突
为什么你写的脚本在同事电脑上不生效？三个高频盲区
不是脚本写得不对，而是 VSCode 的加载边界比想象中窄得多。
-
settings.json里写的terminal.integrated.shell.windows等路径型配置，会被 Settings Sync 静默过滤，不会同步到其他机器 - 插件推荐列表（
extensions.json）只在首次打开项目时提示，如果用户点了 “Don’t show again”，后续再也不会弹窗 - 自定义代码片段若用了非标准 language ID（比如写了
"scope": "tsx"），而 VSCode 实际识别为typescriptreact，那片段就彻底不触发 —— 必须用Developer: Inspect Editor Tokens and Scopes确认真实 ID
