应使用内网共享目录（如Samba/NFS）统一存放.vsix文件并附SHA256校验值，文件名须含扩展ID与版本号（如esbenp.prettier-vscode-12.0.0.vsix），配合install-ext.sh/.ps1脚本一键安装，辅以extensions.json声明推荐插件，实现可审计、可复现的离线协作。
怎么把 .vsix 文件安全传给同事？
直接发文件本身没问题，但要注意路径、权限和版本一致性。VSCode 的 .vsix 文件是 ZIP 格式，不加密、无签名，传输过程不校验完整性——所以别靠微信/邮件附件“随手一发”，容易损坏或被拦截。
推荐做法：
- 用内网共享目录（如 Samba/NFS）存放，路径统一为
/opt/vscode-extensions/或\intranet scode-ext，避免每人存不同位置 - 加 SHA256 校验：下载后执行
shasum -a 256 ms-python.python-2024.12.0.vsix，把哈希值写进同目录的CHECKSUMS.txt，接收方核对 - 文件名必须含扩展 ID 和版本号，例如
esbenp.prettier-vscode-12.0.0.vsix，不能简写成prettier.vsix——否则多人维护时极易装错分支
如何让团队成员一键安装指定 .vsix？
VSCode 本身不支持“静默批量安装”，但可用命令行绕过交互。关键点不是“能不能装”，而是“谁来触发安装”和“装在哪”。
常见误区是让每个成员手动点“Install from VSIX”——效率低、易漏、无法审计。
更可控的方式：
- 在项目根目录放一个
install-ext.sh（Linux/macOS）或install-ext.ps1（Windows），内容为：code --install-extension ./vsix/esbenp.prettier-vscode-12.0.0.vsix - 要求团队首次打开项目时运行该脚本（可写进 README：“首次协作前请执行
./install-ext.sh”） - 注意：该命令只对当前用户生效，且需确保
code命令已加入 PATH；Windows 上 PowerShell 默认禁用脚本执行，需先运行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
为什么 extensions.json 比直接发 .vsix 更适合长期协作？
.vsix 解决的是“装什么”，.vscode/extensions.json 解决的是“该装什么”。前者是一次性动作，后者是可持续的契约。
真正落地时，这两者要配合用：
-
extensions.json放在项目里，声明"recommendations": ["esbenp.prettier-vscode", "ms-python.python"]，告诉所有人“这个项目依赖哪些插件” - 配套提供一个
vsix/目录，里面放对应版本的.vsix文件——用于离线环境或版本锁定场景 - 不要在
extensions.json里写版本号（它不支持），版本控制靠.vsix文件名或 CI 脚本约束 - 如果团队用 GitHub Codespaces 或 devcontainer，可在
.devcontainer/devcontainer.json里用"customizations.vscode.recommendedExtensions"字段复用同一套推荐列表
离线环境下的版本更新怎么管？
没人会记得手动检查 .vsix 是否过期。一旦 Python 扩展升到 2025.1.0，而你还在用 2024.12.0，可能触发 Cannot activate extension 'ms-python.python'. Expected version is 1.98.0+ 这类兼容错误。
最小成本的更新机制：
- 在共享目录里建
LATEST.md，每行格式：ms-python.python → 2025.1.0 (2026-10-20)，人工维护，但比没强 - 用 Git 管理
vsix/目录：每次更新都 commit，并在 message 里写明变更原因（如“修复 Pylance 与 Python 3.13 兼容问题”） - 禁止覆盖重命名旧文件——
ms-python.python-2024.12.0.vsix和ms-python.python-2025.1.0.vsix必须共存，避免有人误删导致回滚困难
最常被忽略的一点：.vsix 文件里嵌的 package.json 会声明 "engines": { "vscode": "^1.85.0" }，如果你的 VSCode 是 1.80.0，哪怕文件能装上，扩展也不会激活——得先升级编辑器，再换 .vsix。
