Go 的 http.FileServer 默认不自动查找并渲染 index.html，需显式启用 http.ServeMux 的文件服务索引支持，或改用 http.StripPrefix 与 http.FileServer 组合确保路径匹配。
go 的 `http.fileserver` 默认不自动查找并渲染 `index.html`，需显式启用 `http.servemux` 的文件服务索引支持，或改用 `http.stripprefix` 与 `http.fileserver` 组合确保路径匹配。
你遇到的问题很典型：使用 http.FileServer(http.Dir("public")) 后访问 http://localhost:8080/ 却无法显示 public/index.html —— 这并非代码逻辑错误，而是 Go 标准库对静态文件服务的默认行为所致。
✅ 正确做法：启用目录索引支持
http.FileServer 本身不会自动响应 / 路径为 index.html；它仅按请求路径严格映射文件。当浏览器请求 / 时，FileServer 会尝试查找名为 ""（空文件名）的资源，自然失败。要支持 index.html 自动作为根路径的默认文档，必须配合 http.ServeMux 并启用其内置的索引逻辑——但更推荐、更可控的方式是显式处理根路径重定向或委托：
✅ 推荐方案：使用 http.StripPrefix + http.FileServer
修改 main.go 如下（关键修复已加注释）：
package main
import (
"net/http"
"github.com/russross/blackfriday/v2" // 注意：v2 是当前主流版本
)
func main() {
// 注册 /markdown 处理器
http.HandleFunc("/markdown", GenerateMarkdown)
// ✅ 正确提供 public/ 下静态文件，并支持 index.html 作为根目录默认页
fs := http.FileServer(http.Dir("public"))
http.Handle("/", http.StripPrefix("/", fs)) // 剥离前导 /，使请求 / → 查找 public/index.html
// 启动服务器
println("Server starting on :8080...")
http.ListenAndServe(":8080", nil)
}
func GenerateMarkdown(w http.ResponseWriter, r *http.Request) {
if r.Method != "GET" {
http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
return
}
body := r.FormValue("body")
if body == "" {
http.Error(w, "Missing 'body' parameter", http.StatusBadRequest)
return
}
markdown := blackfriday.Run([]byte(body))
w.Header().Set("Content-Type", "text/html; charset=utf-8")
w.Write(markdown)
}? 为什么 http.StripPrefix("/", fs) 是关键？
http.FileServer(http.Dir("public")) 期望请求路径（如 /index.html）直接对应 public/index.html。但当你访问 / 时，fs 收到的路径是 /，它会在 public/ 下查找名为 `（空）的文件 —— 不存在。而StripPrefix("/", fs)将/替换为空字符串，于是/→""→public/目录被打开，此时FileServer**内部会主动查找index.html并返回**（这是FileServer` 对目录请求的默认行为）。立即学习“前端免费学习笔记（深入）”；
⚠️ 其他常见陷阱与注意事项
- 路径大小写敏感：确保 public/index.html 文件名完全匹配（Linux/macOS 下 Index.html 或 INDEX.HTML 不会被识别）。
- 工作目录问题：运行二进制时，确保当前工作目录是 myApp（即 main.go 所在目录），否则 http.Dir("public") 会找不到文件。可通过 os.Getwd() 调试验证。
- 构建与运行分离：go build 仅生成可执行文件，必须手动运行该二进制（如 ./myApp）才能启动服务。开发中推荐使用 air 或 gin 实现热重载，避免手动重复 build → kill → run。
- 依赖更新：github.com/russross/blackfriday 已归档，建议升级至 blackfriday/v2（如上例所示），API 更安全、更现代。
✅ 验证步骤（快速确认）
- 确保 myApp/public/index.html 存在且内容有效（例如
Hello from Go!
）； - 在 myApp/ 目录下执行：
go mod init myApp go get github.com/russross/blackfriday/v2 go run main.go
- 浏览器访问 http://localhost:8080/ → 应正确渲染 index.html；
- 访问 http://localhost:8080/markdown?body=**Hello** → 应返回 HTML 格式的加粗文本。
通过以上调整，你的 Go Web 服务器即可稳健、专业地提供静态首页与动态接口，为后续功能扩展打下坚实基础。
