本文通过一个完整的实践案例，介绍如何使用Golang构建一个轻量级的文件管理系统，涵盖目录浏览、文件上传与下载功能，展示Go语言在系统编程中的简洁与高效。

在开发小型项目或内部工具时，我们常常需要一个简单可靠的文件管理服务。与其依赖复杂的第三方平台，不如用Golang自己动手实现一个。凭借其出色的并发支持和标准库能力，Golang非常适合用来构建这类系统级应用。今天，我们就从零开始，搭建一个具备基础功能的文件管理系统。

首先明确需求：用户可以通过浏览器访问服务，查看指定目录下的所有文件和子目录，支持点击下载文件，也能通过表单上传新文件。整个系统不依赖数据库，直接操作本地文件系统，部署简单，维护方便。

我们从项目结构入手。创建一个名为filemanager的目录，在其中新建main.go作为入口文件。整个程序将基于Go的标准库net/http来构建HTTP服务，同时使用os、path/filepath等包进行文件操作。

启动Web服务的代码非常简洁：

go
package main

import (
"log"
"net/http"
)

func main() {
const rootDir = "./shared"

// 确保共享目录存在
if err := os.MkdirAll(rootDir, 0755); err != nil {
    log.Fatal(err)
}

// 设置路由
http.HandleFunc("/", listFiles(rootDir))
http.HandleFunc("/upload", uploadFile(rootDir))
http.HandleFunc("/download/", downloadFile(rootDir))

log.Println("文件服务器启动，监听 :8080")
log.Fatal(http.ListenAndServe(":8080", nil))

}

核心逻辑围绕三个处理函数展开：listFiles用于展示目录内容，uploadFile接收上传请求，downloadFile提供文件下载。

先看目录浏览功能。我们需要读取指定路径下的所有条目，并生成HTML页面返回给浏览器。这里使用os.ReadDir遍历目录，区分文件和文件夹，并构造链接：

go
func listFiles(root string) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
path := filepath.Join(root, r.URL.Path)
entries, err := os.ReadDir(path)
if err != nil {
http.Error(w, "无法访问目录", http.StatusForbidden)
return
}

    var buf strings.Builder
    buf.WriteString("<h2>文件列表</h2><ul>")
    for _, entry := range entries {
        name := entry.Name()
        href := r.URL.Path + "/" + name
        if entry.IsDir() {
            buf.WriteString(fmt.Sprintf(`<li>[DIR] <a href="%s">%s/</a></li>`, href, name))
        } else {
            dlLink := "/download" + href
            buf.WriteString(fmt.Sprintf(`<li>[FILE] <a href="%s">%s</a> (<a href="%s">下载</a>)</li>`, href, name, dlLink))
        }
    }
    buf.WriteString("</ul>")

    // 上传表单
    buf.WriteString(`
        <h3>上传文件</h3>
        <form method="POST" action="/upload" enctype="multipart/form-data">
            <input type="file" name="file" required />
            <button type="submit">上传</button>
        </form>
    `)

    w.Header().Set("Content-Type", "text/html; charset=utf-8")
    w.Write([]byte(buf.String()))
}

}

上传功能则通过解析multipart/form-data表单数据实现。我们限制单个文件大小为10MB，防止恶意上传：

go
func uploadFile(root string) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
if r.Method != "POST" {
http.Redirect(w, r, "/", http.StatusSeeOther)
return
}

    r.ParseMultipartForm(10 << 20) // 10MB limit
    file, handler, err := r.FormFile("file")
    if err != nil {
        http.Error(w, "上传失败", http.StatusBadRequest)
        return
    }
    defer file.Close()

    dstPath := filepath.Join(root, handler.Filename)
    dst, err := os.Create(dstPath)
    if err != nil {
        http.Error(w, "保存失败", http.StatusInternalServerError)
        return
    }
    defer dst.Close()

    io.Copy(dst, file)
    http.Redirect(w, r, "/", http.StatusSeeOther)
}

}

下载功能更简单，只需设置正确的Header并调用http.ServeFile：

go func downloadFile(root string) http.HandlerFunc { return func(w http.ResponseWriter, r *http.Request) { filePath := filepath.Join(root, r.URL.Path[len("/download/"):]) if _, err := os.Stat(filePath); os.IsNotExist(err) { http.NotFound(w, r) return } w.Header().Set("Content-Disposition", fmt.Sprintf("attachment; filename=%s", filepath.Base(filePath))) http.ServeFile(w, r, filePath) } }

整个系统不到200行代码，却已具备实用功能。你可以将其部署在内网服务器上，用于团队间临时共享文档。通过调整rootDir变量，可以指定不同的共享目录。若需增强安全性，可加入身份验证中间件，或限制可访问的路径范围。

Golang的魅力正在于此：无需引入大量依赖，仅靠语言本身提供的强大标准库，就能快速构建出稳定高效的系统工具。这个文件管理器只是一个起点，你还可以扩展搜索功能、添加文件删除接口，甚至集成前端框架提升用户体验。