如何在 Go 中发现局域网内计算机的共享文件夹_技术教程

本文介绍在 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 工具），并相应调整解析逻辑。