本文介绍在 go 程序中探测局域网内远程 windows 计算机（如 `computera`）上所有共享文件夹的实用方法，由于标准库不支持 unc 根路径枚举，需借助系统命令（如 `net view`）并安全解析其输出。
Go 的标准库（如 os, io/ioutil（已弃用，推荐 os.ReadDir）或 net 包）无法直接枚举远程主机的共享列表。尝试使用 os.ReadDir("\\\\ComputerA") 会失败，因为 UNC 路径 \\\\ComputerA 并非一个可遍历的“目录”，而是一个 SMB 共享命名空间的逻辑入口——这与 Windows 资源管理器能展示共享列表是不同层级的实现（Explorer 调用了 Windows API 如 NetShareEnum）。
因此，跨平台原生支持虽不可行，但在 Windows 环境下，最可靠、轻量且无需额外依赖的方式是调用系统内置命令：
✅ 推荐方案：使用 net view 命令
net view \ComputerA 是 Windows 命令行工具，专用于列出指定计算机上所有活动的共享资源（包括共享名、类型和备注）。它基于 SMB 协议通信，权限要求与资源管理器一致（需目标主机启用“网络发现”且共享可见，当前用户具有读取共享枚举权限）。
以下是一个健壮的 Go 示例，包含错误处理、输出解析与结构化返回：
package main
import (
"bufio"
"fmt"
"os/exec"
"strings"
)
// Share 表示一个网络共享项
type Share struct {
Name string
Type string // e.g., "Disk", "Printer", "IPC"
Remark string
}
// ListShares 获取指定主机的所有共享文件夹（仅限 Windows）
func ListShares(host string) ([]Share, error) {
cmd := exec.Command("net", "view", "\\"+host)
output, err := cmd.Output()
if err != nil {
// 检查是否为退出码错误（如主机不可达、无权限等）
if exitErr, ok := err.(*exec.ExitError); ok {
return nil, fmt.Errorf("net view failed for %s: %w (exit code: %d)",
host, exitErr, exitErr.ExitCode())
}
return nil, fmt.Errorf("failed to run net view: %w", err)
}
var shares []Share
scanner := bufio.NewScanner(strings.NewReader(string(output)))
inShareSection := false
for scanner.Scan() {
line := strings.TrimSpace(scanner.Text())
// 跳过空行和标题分隔线
if line == "" || strings.HasPrefix(line, "--") {
continue
}
// 找到共享列表起始标识（典型输出中含 "Share name" 表头）
if strings.Contains(line, "Share name") && strings.Contains(line, "Type") {
inShareSection = true
continue
}
if !inShareSection {
continue
}
// 忽略末尾的摘要行（如 "The command completed successfully."）
if strings.Contains(line, "command completed") || strings.Contains(line, "成功") {
break
}
// 按至少两个空格分割（避免名称含空格被误切），取前两字段为 Name 和 Type，其余为 Remark
parts := strings.Fields(line)
if len(parts) < 2 {
continue
}
name := parts[0]
typ := parts[1]
remark := strings.Join(parts[2:], " ")
shares = append(shares, Share{
Name: name,
Type: typ,
Remark: strings.TrimSpace(remark),
})
}
if err := scanner.Err(); err != nil {
return nil, fmt.Errorf("error scanning output: %w", err)
}
return shares, nil
}
func main() {
shares, err := ListShares("ComputerA")
if err != nil {
fmt.Printf("Error: %v\n", err)
return
}
fmt.Printf("Found %d shares on ComputerA:\n", len(shares))
for _, s := range shares {
if s.Type == "Disk" { // 可选：只关注文件共享
fmt.Printf("- %s (%s): %s\n", s.Name, s.Type, s.Remark)
}
}
}⚠️ 注意事项与最佳实践
- 权限与网络配置：确保运行 Go 程序的账户对 ComputerA 具有 SMB 枚举权限；目标主机需开启“网络发现”、“文件和打印机共享”，且防火墙允许 SMB (TCP 445) 或 NetBIOS (UDP 137-139) 流量。
- 输出格式兼容性：net view 输出可能因 Windows 版本或系统语言略有差异（如中文系统显示“共享名”而非“Share name”）。生产环境建议添加多语言适配或改用更稳定的替代方案（如调用 Windows API 的 CGO 封装，或使用 PowerShell 的 Get-SmbShare）。
- 安全性：避免拼接不可信的 host 参数（防止命令注入），应严格校验主机名格式（仅字母、数字、短横线、点号）。
- 跨平台局限性：此方法仅适用于 Windows 客户端。Linux/macOS 需改用 smbclient -L //ComputerA -N（需预装 Samba 工具），并相应调整解析逻辑。
✅ 总结
当 Go 标准库无法满足底层网络文件系统元数据查询需求时，合理调用宿主系统的成熟工具（如 net view）是高效、低侵入的工程实践。关键在于封装好命令执行、健壮解析输出、妥善处理错误边界，并始终遵循最小权限原则。对于企业级应用，可进一步封装为带超时、重试和日志追踪的共享发现服务。
