离线安装 Go 插件需三步：下载正确版本的 golang.go.vsix（推荐 Open VSX Registry），用 code --install-extension 命令行安装，再手动部署 gopls.exe 并配置 go.gopls.path 和 GOPATH/GOROOT。
离线安装 Go 插件（golang.go）的 .vsix 文件
离线安装 Go 插件本身不难，关键在获取正确版本的 .vsix 文件。VS Code 官方市场被屏蔽或不可达时，推荐用 Open VSX Registry 替代：访问 https://www.php.cn/link/87399f176ecbb33c635159c25c156c7f，搜索 golang.go，选最新稳定版，点击 “Download” 得到 .vsix 文件。
注意以下三点：
- 文件名不要手动右键重命名（尤其 Windows），避免浏览器加双后缀（如
golang.go-2024.10.2.vsix.zip）；用 PowerShell 执行Copy-Item "old.zip" "golang.go-2024.10.2.vsix" -Force - 下载后校验完整性：
unzip -t golang.go-2024.10.2.vsix，报错说明损坏，需重下 - 打开本地 VS Code 的“关于”窗口，确认版本号（如
1.92.2），再检查.vsix包内package.json的"engines": { "vscode": "^1.90.0" }是否兼容
安装后插件不生效？大概率缺 gopls
装完 golang.go 插件只是第一步。VS Code 的 Go 跳转、补全、诊断等功能依赖 gopls 这个语言服务器——它不是插件自带的，必须单独部署。
离线环境下，gopls 只能手动搬运：
立即学习“go语言免费学习笔记（深入）”；
- 在有网机器上，VS Code 中按
Ctrl+Shift+P输入Go: Locate Configured Go Tools，找到gopls对应路径（Windows 下通常是%USERPROFILE%\go\bin\gopls.exe） - 把整个
gopls.exe拷到离线机相同路径（或任意固定路径，如C:\tools\gopls.exe） - 打开 VS Code 设置（
Ctrl+,），搜go.gopls.path，填入你放gopls.exe的完整路径（含.exe） - 同时确保
go.useLanguageServer为true
命令行安装比图形界面更可靠
图形界面点“从 VSIX 安装…”有时静默失败，尤其当插件含依赖或签名异常时。推荐用 CLI 方式安装，错误提示直接：
- 先关闭所有 VS Code 进程（Windows 可任务管理器查
Code.exe，macOS/Linux 执行killall code） - 确认
code命令可用：按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH启用 - 执行：
code --install-extension "C:\path\to\golang.go-2024.10.2.vsix"（Windows 路径含空格必须加引号） - 安装成功后，按
Ctrl+Shift+P输入Developer: Show Running Extensions，确认golang.go状态是Local而非Marketplace
别漏掉 GOPATH 和 GOROOT 的离线配置
即使插件和 gopls 都到位，如果 go env 输出里 GOPATH 或 GOROOT 是空的或指向错误位置，VS Code 仍会报 Cannot find module providing package ... 类错误。
离线机上必须手动设置：
-
GOROOT指向 Go 安装目录下的src上一级（如C:\Go），不是bin -
GOPATH设为工作区根目录（如C:\mygo），并确保该目录下有src、bin、pkg三个子目录 - Windows 在系统环境变量中新增这两项；macOS/Linux 在
~/.zshrc或~/.bash_profile中加export GOPATH=...和export GOROOT=... - 重启 VS Code 后，在集成终端运行
go env GOPATH和go env GOROOT验证
最易忽略的是 gopls 路径配置和 GOPATH 目录结构——这两个点没对，其余全装对也白搭。
