Hexo云服务器部署后仅显示文字的原因分析与解决方案

部署路径配置错误

当Hexo部署到云服务器子目录而非根目录时，主题资源默认的根路径（/css/、/js/）会指向错误位置，导致样式文件无法加载。需在_config.yml中修改url和root字段为实际部署路径（如url: https://example.com/blog/）。

解决方法步骤：

1. 检查云服务器上Hexo项目的实际访问路径
2. 修改_config.yml的URL参数
3. 执行hexo clean && hexo g -d重新部署

静态资源引用问题

主题的CSS/JS文件若使用相对路径引用，在非根目录部署时会因路径层级变化导致404错误。可通过以下方式修复：

• 在主题配置文件中强制使用绝对路径
• 检查_config.yml的relative_link是否设置为false
• 使用hexo-asset-image插件处理图片资源路径

服务器权限与依赖缺失

云服务器环境需满足以下条件才能正常渲染页面：

• Git仓库具有读写权限（推荐使用chmod 755设置目录权限）
• 安装Node.js和Hexo运行时依赖（通过npm install补齐缺失模块）
• 配置SSH密钥实现免密部署（验证命令ssh -T git@github.com）

Nginx配置不当

Web服务器配置错误会导致静态资源无法加载，常见问题包括：

• Nginx的root路径未指向Hexo生成的public目录
• 未正确配置MIME类型（如application/javascript）
• 未设置静态资源缓存策略（建议添加expires 30d）

部署后仅显示文字的核心原因可归纳为路径映射错误、资源加载失败和运行环境异常三类。建议按照配置检查→路径修正→权限验证→部署测试的流程排查问题，特别注意云服务器与本地环境的路径差异。通过规范部署流程和自动化脚本可有效避免此类问题。