静态网站模板：3个坑比选框架更耽误事

静态网站模板这东西，问题往往不在挑选的时候，而在改动的时候。买回来那天看着挺顺眼，上线三个月想加个栏目、换条导航，才发现整套页面是焊死的——这时候再换框架，前面排的版、写好的文案、调过的移动端全得陪着重来一遍。下面说三个我见得最多的坑，它们比选哪个框架更耽误事。

静态网站模板的问题，大多不在画面上

挑模板时，人的眼睛都盯着首屏那张大图、配色、字体，这些恰恰最不值钱。一套模板真正决定你后面累不累的，是它怎么组织文件、内容怎么落地、构建出来的东西能不能直接放到虚拟主机上运行。画面不满意，改 CSS 就行；结构不对劲，返工量就大了。

坑一：模板里塞了一大堆你永远不会用的东西

从主题市场下载下来的模板，十个里八个带着一堆插件——轮播、灯箱、表单校验、滚动动画、图标全家桶，还有某个早就不流行的视差特效。作者图的是演示页好看、功能列表长，你上线之后这些代码照样会打进产物，用户照样得下载。移动端打开慢半拍，很多时候就是这些边角料攒出来的。

想删也不是不行，麻烦在于删之前得先弄清楚哪块样式还依赖它。有些模板的 CSS 是编译过的，你动一个 js，某个区块当场塌掉。比较稳的做法是先翻构建配置，看看依赖列表有多长，有没有一堆你用不上的 loader 和 preset。清单越短，后面越自由。

坑二：所谓“可编辑”，很多时候是假的

有的模板宣传页写着内容与样式分离，打开一看，首页那几段文案全写死在 HTML 里，标题纯粹当装饰，图片路径直接是 /images/hero-xxx.jpg 这种形式。你想把首屏换成产品介绍，得一个文件一个文件去搜。

判断方法简单得很，看有没有 content/ 或者 data/ 目录，文章和页面配置是不是 md、yaml、json 这类能被程序读的文件。有，说明作者想过你会改；没有，说明这套东西是给演示看的，不是给长期用的。

还有一个容易忽略的点是路径。不少模板的图片和 CSS 写的是根目录绝对路径，站放根目录时没事，一旦你想挂到 /blog/ 这种子目录，整站资源全裂。买之前翻两页源码就能看出来，别等上线了才发现。

坑三：模板和你的托管环境不对付

这个坑最让人头疼。现在流行的那些生成器，构建那一步要 Node 环境，产物落在 dist/ 或者 public/ 里。你在本地跑没问题，传到一台只能放静态文件的虚拟主机上也没问题，前提是你传的是产物，不是源码。有人指望在主机上装依赖、跑 build，主机那边并不提供这个权限，于是怪模板不好——其实是两边环境不匹配。

还有伪静态。路由靠 js 处理的模板，刷新二级页面容易 404，要配 nginx 的 try_files 或者 .htaccess 的 rewrite 才正常。买之前问一句：这套东西产出的是纯静态文件吗，需不需要服务端重写规则。问清楚能省很多来回。

框架选型这件事被高估了

论坛上 Astro 和 Hugo 谁快，能吵几十页。说实话对大多数内容站来说，这几个都够用，真正让你加班的是模板结构，不是框架名字。锤子都差不多，钉子的形状才要命。

所以我建议的顺序是反的：先想清楚内容模型——以后发什么、栏目怎么分、列表页要露哪些字段，再去挑模板。先看截图挑模板，最后内容被模板绑死，这个流程我见过太多次。

演示内容不清，上线先被搜到一堆假文章

这条单独拎出来说。模板自带的那几篇示例文章、示例作者、示例产品价格，很多人忘了删，或者删了页面内容但 sitemap 和 RSS 里还留着。上线一两周，搜索里出来的全是别人的演示标题，体验很糟。清理的时候顺手把 sitemap、robots.txt、页脚版权、社交卡片图一起过一遍，别只删首页。

一套能省事的静态网站模板，长什么样

按我的口味，几条：目录干净，content、layouts、assets、public 各干各的；依赖清单短，一次构建能在喝杯茶的工夫里跑完；组件拆得开，导航、页脚、卡片各是各的文件；图片走相对路径或者可配置的 base；README 里写清楚怎么构建、产物在哪。

前三条满足，后面基本不用太操心。缺一两样可以自己补，缺太多就别硬上，换一套模板比重构一套模板便宜得多。

接手别人的模板，先做三件事

二手的、别人交接的模板，先别急着改样式。

一，原封不动跑一遍构建，看能不能一次成功；二，git 初始化提交一次，任何改动前都有得退；三，挑一个最小的页面动手，把导航文案换掉、把一张图换掉，这条流程跑通了再动大结构。

备份多说一句。改崩了最怕的是没有原始版本对照，改到一半自己也忘了动过哪儿。原始包单独留一份，别在同一个目录里改来改去。托管那边如果支持整站快照或者定期备份，也顺手开上，具体以服务商后台说明为准。

收一下：按画面挑模板挑不出问题，问题都埋在结构里；能不能在你的环境里跑，买之前问清楚；动刀之前先备份、先跑通构建。这三步做完，框架叫什么名字，其实不太影响你上线。