使用Gin框架时无法加载.html以外的静态文件问题

以下是针对你问题的具体排查和解决步骤：

1. 简化静态资源路由配置 #

你当前逐个配置子目录的方式容易出错，建议用统一挂载替代所有分散的r.Static配置：

// 替换原来所有的静态路由配置，一行搞定static目录下所有子资源
r.Static("/static", "./static")

这样Gin会自动处理/static/css、/static/images、/static/js等所有子路径请求，直接对应项目中./static目录下的同名子文件夹。

如果需要保留/static/img映射到./static/images的特殊规则，可以在统一挂载后单独设置（优先级更高）：

r.Static("/static", "./static")
r.Static("/static/img", "./static/images")

2. 核对HTML中的资源引用路径 #

确保HTML里的资源路径和Gin配置的路由完全匹配：

• CSS文件：<link rel="stylesheet" href="/static/css/xxx.css">
• 图片文件：若用了/static/img映射规则，引用路径应为<img src="/static/img/xxx.jpg">；若用统一挂载，路径则是<img src="/static/images/xxx.jpg">
• JS文件：<script src="/static/js/xxx.js"></script>

3. 确认程序运行的工作目录 #

执行go run main.go时，必须保证终端当前目录是项目根目录（即包含main.go和static文件夹的目录）。如果在子目录运行，相对路径./static会找不到文件。

可以用pwd（Linux/macOS）或cd命令（Windows）切换到项目根目录后再启动服务。

4. 直接测试静态资源可访问性 #

启动服务后，在浏览器直接访问静态资源URL，比如http://localhost:3000/static/css/xxx.css：

• 若能看到文件内容，说明路由配置正常，问题出在HTML的引用路径上
• 若返回404，检查文件是否存在、路径映射是否正确

内容的提问来源于stack exchange，提问作者kiyoshi