hexo 学习►配置

hexo 学习 0004:0004-hexo 站点配置

一、前言：配置文件的重要性

在 Hexo 中，根目录下的 _config.yml 是整个站点的“大脑”，它决定了网站的元信息、语言、时区、部署方式等核心行为。与主题配置文件（位于 themes/xxx/_config.yml）不同，站点配置是全局性的，影响所有内容的生成与展示。

配置得当，不仅能提升用户体验，还能增强搜索引擎收录效果，是搭建高质量博客的第一步。

本文将围绕站点基础信息、本地化设置、常见问题排查等方面，为你提供一份完整、实用的 Hexo 站点配置指南。

二、核心配置详解

1. 站点基础信息

这些字段是网站的“身份证”，直接影响搜索引擎和访客对你的第一印象。

配置项	说明	示例
`title`	网站主标题，显示在浏览器标签和页面头部	`Hexo Learn`
`subtitle`	副标题，补充说明网站定位	`染青的 Hexo 学习笔记`
`description`	网站描述，用于 SEO，建议简洁明了	`记录 Hexo 学习与实践的心路历程`
`keywords`	关键词列表，提升搜索引擎可见度	`[hexo, 博客, 教程, 静态网站]`
`author`	作者名，默认应用于所有文章	`染青`

YAML 写法示例：

title: Hexo Learn
subtitle: 染青的 Hexo 学习笔记
description: 实践是检验学习的唯一标准，Hexo 也不例外。
keywords: [hexo, learn, blog, 教程]
author: 染青

提示：keywords 支持多个关键词，建议选择与内容强相关的词汇，避免堆砌。

2. 本地化配置（Language & Timezone）

这是许多中国用户容易忽略但极其关键的部分。正确的本地化设置能让博客更“接地气”，避免时间错乱、语言显示异常等问题。

`language`：语言设置

作用：控制站点界面语言（如“上一篇”、“下一篇”、“发表于”等文本）。
格式：支持字符串或列表（用于多语言回退）。
推荐值：
- 简体中文：zh-CN
- 繁体中文：zh-TW
- 英语：en

注意：语言设置依赖主题支持。若主题未提供 zh-CN.yml 文件，则无法显示中文。

多语言回退示例：

1
2
3

language:
  - zh-CN
  - en

表示优先使用简体中文，若无对应翻译则回退到英文。

`timezone`：时区设置

作用：确保文章发布时间、归档日期等时间相关功能准确。
常见误区：虽然中国统一使用北京时间（UTC+8），但在 Unix 时区数据库中，标准标识为 Asia/Shanghai，而非 Beijing 或 China。
推荐值：Asia/Shanghai

配置示例：

1 2	language: zh-CN timezone: Asia/Shanghai

为什么是 Shanghai？
因为 Linux/Unix 系统的时区数据库（TZ Database）以城市命名，上海是代表中国标准时间的官方城市标识。

三、配置参数总览表

为方便查阅，整理如下：

设置项	描述	推荐值（中国用户）
`title`	网站标题	`Hexo Learn`
`subtitle`	网站副标题	`染青的 Hexo 学习笔记`
`description`	网站描述（SEO 关键）	`记录 Hexo 学习与实践...`
`keywords`	关键词列表	`[hexo, 博客, 教程]`
`author`	作者名	`染青`
`language`	网站语言（ISO 639-1）	`zh-CN`（简体中文）
`timezone`	网站时区（TZ Database）	`Asia/Shanghai`

四、常见问题与解决方案

问题1：设置了 `language: zh-CN`，但页面仍是英文？

原因：当前主题未提供中文语言包。

解决方案：

检查主题目录下是否存在 languages/zh-CN.yml 文件（路径如：themes/next/languages/zh-CN.yml）。
若无，可尝试：
- 切换回 en 使用英文；
- 为该主题创建中文语言文件；
- 更换支持中文的主题（如 Butterfly、Fluid）。

问题2：文章发布时间总是差8小时？

原因：timezone 配置错误或系统时区不一致。

解决方案：

确保 _config.yml 中设置为 timezone: Asia/Shanghai。
检查操作系统时区是否正确。
避免在文章 Front-matter 中硬编码错误时间。

问题3：YAML 配置语法错误？

常见错误：

冒号后缺少空格（key:value → key: value）
使用 Tab 缩进（应使用空格）
中文冒号或引号未转义

建议：使用 VS Code 等编辑器，安装 YAML 插件，可自动高亮语法错误。

五、结语

一个优秀的 Hexo 博客，始于一份严谨的配置。通过合理设置 title、description、language 和 timezone，你不仅能提升博客的专业度，还能为后续的 SEO、多语言支持、时间管理打下坚实基础。

小贴士：配置完成后，别忘了运行 hexo clean && hexo g 重新生成站点，让更改生效！

实践是检验学习的唯一标准，Hexo 也不例外。愿你在搭建博客的路上，不仅学会工具，更学会思考与表达。