生而为人

程序员的自我修养

0%

Posted on In

bad indentation of a mapping entry

  1. title中缩进不正常，均要用tab缩进

warning: adding embedded git repository: themes/next

1
2
3
4
5
6
7
8
9
10
11
12
13
14
warning: adding embedded git repository: themes/next
hint: You've added another git repository inside your current repository.
hint: Clones of the outer repository will not contain the contents of
hint: the embedded repository and will not know how to obtain it.
hint: If you meant to add a submodule, use:
hint:
hint: 	git submodule add <url> themes/next
hint:
hint: If you added this path by mistake, you can remove it from the
hint: index with:
hint:
hint: 	git rm --cached themes/next
hint:
hint: See "git help submodule" for more information.

git仓库包含子仓库时，add报错的解决办法

参考资料

hexo部署成功仍未更新或无法打开的情况

修改scheme后发布不起作用

Hexo博客 Next更换修改主题样式 不生效的解决

Posted on In

[toc]

给我一个Front-matter例子

这里是一个包含了常用字段的 Hexo Front-matter 示例，可以直接复制使用：

yaml

复制下载

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
---
title: 使用Hexo搭建个人博客的完整指南
date: 2026-04-24 10:30:00
updated: 2026-04-25 15:20:00
tags:
  - Hexo
  - GitHub Pages
  - 教程
categories:
  - [技术, 前端, 静态博客]
  - [工具]
keywords: Hexo,博客搭建,教程
description: 这是一篇详细介绍如何使用Hexo和GitHub Pages搭建个人博客的文章，包含完整的配置步骤和常见问题解答。
author: 你的名字
layout: post
comments: true
toc: true
---

📌 各项字段说明

字段 是否必需 作用
title ✅ 必需 文章标题，会在页面上显示
date ✅ 必需 文章创建时间，影响排序和归档
updated ❌ 可选 文章最后修改时间，SEO友好
tags ❌ 可选 文章标签（可以是列表或单值）
categories ❌ 可选 文章分类，支持多级层级（写法如示例所示）
keywords ❌ 可选 用于SEO的页面关键词
description ❌ 可选 页面描述，在搜索引擎结果中展示
author ❌ 可选 作者名（若主题支持多作者时可使用）
layout ❌ 可选 指定布局模板，默认post
comments ❌ 可选 是否开启评论（需主题支持）
toc ❌ 可选 是否显示目录（需主题支持）

💡 关于 categories 多级写法的补充说明

如果你希望一篇文章同时属于 两个不同的分类体系（例如既属于“日常/游记”，又属于“创作/散文”），可以这样写：

yaml

复制下载

1
2
3
categories:
  - [日常, 游记]    # 父级“日常”，子级“游记”
  - [创作, 散文]    # 另一个独立的分类路径

Hexo 会自动为这两个分类路径分别生成页面，文章会出现在两个分类页面中。

如果你希望一个分类下有两级（只有一条路径），也可以简写为：

yaml

复制下载

1
2
3
categories:
  - 技术
  - 后端

但这会被解析为两个同级分类，而不是层级关系。要表示层级，必须用数组嵌套：- [技术, 后端]。

⚙️ 快速生成 Front-matter

可以使用 hexo new "标题" 命令自动生成带有 title 和 date 的基础 Front-matter；如需更多字段，建议使用 VS Code 的 Hexo Front-matter 等插件，或自己复制模板文件到 scaffolds/post.md 中。

例如，修改 scaffolds/post.md 为你想要的模板：

yaml

复制下载

1
2
3
4
5
6
7
8
9
---
title: {{ title }}
date: {{ date }}
updated: 
tags:
categories:
description: 
toc: true
---

这样之后每次 hexo new "标题" 都会生成带有这些字段的文件。

Posted on

[toc]

如何在文中引用生成的其他页面

在 Hexo 中引用其他页面，主要有三种方法，你可以根据对便捷性、灵活性和可维护性的需求来选择。

📝 方法一：标准 Markdown 链接（最基础）

这是最直接的方法，使用标准的 Markdown 链接语法 [显示文字](链接地址)。

  • 操作方式：你需要手动填写目标文章的相对路径或绝对路径--10。
  • 优点：通用性强，不依赖任何 Hexo 特性，在所有主题和编辑器下都能工作。
  • 缺点：一旦文章的URL 结构（Permalink）发生变化，所有手动书写的链接都会失效，维护成本较高。

🚀 方法二：Hexo 标签插件（官方推荐）

Hexo 提供了内置的 post_link 标签插件，这是官方推荐的做法--10。

  • 操作方式：在文章中这样使用：

    1
    {% post_link 目标文章的文件名（不含.md后缀） "自定义显示文字（可选）" %}

    例如，要引用 source/_posts/hello-world.md 这篇文章--4：

    1
    2
    {% post_link hello-world %}
    {% post_link hello-world 你好，世界！ %}

  • 优点：

    • 智能解析：Hexo 会自动根据文章文件名找到正确的 URL-10。
    • 高可维护性：即使你修改了文章的 permalink 配置，链接也依然有效，无需手动更改-10。
    • 多语言友好：能更好地适应多语言站点-10。

  • 缺点：语法不是标准 Markdown，在部分编辑器（如 Typora）中可能无法实时预览。

🔌 方法三：社区插件（功能更强大）

如果你追求更优雅的语法或更高级的功能，可以安装社区插件。

  • 1. 回归标准 Markdown 语法：hexo-post-link
    • 这个插件让你能用标准的 Markdown 链接语法来实现 post_link 的效果--5。
    • 操作方式：安装插件后，链接写法变为 [显示文字](文章文件名)-5。Hexo 在生成时会自动将文件名替换为正确的 URL。
    • 优点：兼顾了标准语法和智能解析。
  • 2. 拥抱 Wiki 链接：hexo-filter-titlebased-link
    • 如果你习惯使用 [[双链]] 语法（尤其在 Obsidian 等笔记软件中），这个插件将非常适合你--1。
    • 操作方式：安装并配置后，可以直接使用 [[目标文章标题]] 或 [[目标文章标题|自定义别名]] 来创建链接-1。
    • 高级功能：它甚至可以生成“反向链接”，让你在主题中展示有哪些文章引用了当前文章，构建知识图谱-1。

💡 补充：链接到文章的特定章节

如果你想链接到另一篇文章的某个具体小标题，也是完全可以的。

  • 操作方法：在链接地址后加上 # 和小标题的 id。

  • Hexo 默认行为：Hexo 默认的 Markdown 渲染器会自动为每个小标题（##、### 等）生成一个 id，通常就是标题文字本身。

  • 示例：假设你要引用的文章中有个 ## 总结 的标题，你可以这样链接：

    1
    [跳转到那篇文章的总结部分]({% post_link target-article %}#总结)

    小技巧：如果不确定某个标题的准确 id，可以在浏览器中打开该文章，按 F12 打开开发者工具，检查（Inspect）那个标题元素，就能看到它的 id 属性值。

💎 总结与建议

方法 核心操作 优点 缺点 推荐场景
标准 Markdown 链接 [文字](/path/to/page) 简单直接，通用性强 链接硬编码，URL 变更后易失效 临时引用，或引用站外链接
post_link 标签 {% post_link 文件名 %} 官方支持，稳定可靠，自动适配 URL 变化-10 语法非标准 Markdown 绝大多数内部引用场景（首选）
社区插件 [文字](文件名) 或 [[标题]] 语法优雅，功能强大（如支持反向链接）-1 需要额外安装和配置 追求极致写作体验，或需要构建知识网络

对于大多数情况，直接使用 Hexo 自带的 post_link 标签插件是兼顾了便捷与可靠的最佳选择。

Posted on In

主题

  1. One dark vivid Italic（plugins - One Dark theme）

Posted on In

必装插件

CamelCase

  1. Shift + Alt + U
  2. editor中可以选择转换的模式

识别文件

Rainbow CSV

CSV

ExcelReader

主题

One Dark theme

常用快捷键

find Declaration or Usage:

参考资料：

  1. 快捷键