汇总使用中的常见疑问与已知限制。
返回 使用指南总览
安装与启动
Q：需要先安装 Node.js 吗？
日常使用不需要。应用内嵌了 Hexo 引擎，写作、预览、生成、部署都能跑。
只有两个场景需要本机 Node.js：新建站点（要装依赖）和安装 / 卸载插件（走 npm）。
Q：绿色版双击没反应？
确认是解压后再运行，不要在压缩包预览窗口里直接双击。压缩包内运行会因为解压慢而看起来”没反应”。
Q：启动时提示找不到站点？
上次打开的站点目录可能被移动或删除了。重新点「添加站点」选择正确位置即可。
站点与数据
Q：HexoDeck 会修改我的站点文件吗？
只在你主动执行操作时修改，且都是最小改动：
- 保存配置 → 行级替换，保留注释与键顺序，首改自动备份
- 编辑文章 → 只改你编辑的那个文件
- 设置站点图标 → 写入
source/favicon.*
应用本身不往站点里写任何自己的状态文件。
Q：我的站点数据存在哪？
应用自己的数据（最近站点、文集定义、配置路径记忆、应用设置）都存在 %APPDATA%/hexodeck/hexodeck.json，不进站点目录。
如果删掉这个文件，只会丢失应用记忆（最近站点、文集入口等），站点文件不受影响。
Q：多个博客会混在一起吗？
不会。所有自定义内容都按站点隔离：
| 内容 | 隔离方式 |
|---|---|
| 文集定义 | 按站点路径分组 |
| 自定义参数定义（含类型与开关值） | 按站点路径分组 |
_config.yml 路径记忆 |
按站点 |
| 主题配置路径记忆 | 按「站点 + 主题」 |
切换站点时界面会自动重新加载对应的数据。
写作相关
Q：文章保存在哪？
- 正式文章 → 站点
source/_posts/ - 草稿 → 站点
source/_drafts/ - 文集文章 → 你指定的目录
都是普通的 Markdown 文件，可以直接用其他编辑器打开。
Q：删除文章能恢复吗？
可以。删除是移入系统回收站，从回收站还原即可。
Q：开关式参数写了 false 但主题还显示评论？
这是最容易踩的坑 —— 检查 front-matter 里写的是布尔还是字符串：
1 | comments: false # ✅ 布尔，主题能正确识别 |
HexoDeck 的开关式参数会写布尔值，所以用开关式添加的参数不会有这个问题。如果你手动在 YAML 里写，注意别加引号。
Q：结构化参数能写多复杂？提取码为什么变成了数字？
结构化参数支持任意深度的嵌套对象与对象数组 —— 键值对、列表、列表里再套对象都可以，层数不受限制。
要注意的是 YAML 的类型推断：
1 | password: 1234 # ❌ 被解析成数字 |
提取码、验证码、卡号这类「号码」都建议加引号。HexoDeck 会保留你写的引号，但如果你手写时漏了，YAML 规范层面它就已经是数字了 —— 某些主题模板做字符串比较时会因此出错。
Q：字数统计是怎么算的？
中文按字计，英文按单词计（汉字/假名/谚文逐字算，拉丁字母连成词算一个）。全应用统一这个口径：编辑器状态栏、文章列表、统计页都一致。
预览与部署
Q：预览显示不出来？
- 确认站点能正常生成 —— 去「发布」页点「生成静态页面」看有没有报错
- 检查端口占用 —— 预览会用 4000 起的空闲端口，一般不会冲突
- 如果预览页面空白，看「发布」页日志区有没有 hexo 报错
Q：部署显示成功但网站没变？
先确认是不是真成功 —— 看日志区有没有报错。HexoDeck 会识别 git 推送失败并明确报错，如果日志里没有错误提示，说明推送确实成功了。
那么检查方向转向 GitHub 侧：
- 仓库的 commit 时间是否更新
- GitHub Pages 的构建状态（仓库 Settings → Pages）
- 浏览器缓存（强制刷新试试）
Q：部署提示”分支为空”？
去「设置 → 部署」把分支填上（GitHub Pages 一般是 main），旁边有一键填入按钮。
Q：仓库地址要加 .git 吗？
建议加。https://github.com/用户名/仓库 这种形式在某些情况下会被 git 当成路径而非仓库，应用会提示你补全。
已知限制
- 仅支持 Windows（10 / 11，64 位）。macOS / Linux 暂无打包版本。
- 界面语言为中文，暂无多语言支持。
- 安装 / 卸载插件需要本机 Node.js —— 日常写作、预览、生成、部署都不需要。
- 文集内容是否被生成到博客取决于 Hexo 配置 —— 下划线开头的目录（如
source/_dynamics）Hexo 默认跳过；想让内容上线，放进source/下的常规目录。
反馈问题
使用中遇到问题或有建议，欢迎在 GitHub 提 issue：
评论