Hexo云服务器部署后仅显示文字的原因分析与解决方案
部署路径配置错误
当Hexo部署到云服务器子目录而非根目录时，主题资源默认的根路径（/css/、/js/）会指向错误位置，导致样式文件无法加载。需在_config.yml中修改url和root字段为实际部署路径（如url: https://example.com/blog/）。
解决方法步骤：
- 检查云服务器上Hexo项目的实际访问路径
- 修改
_config.yml的URL参数 - 执行
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）
部署后仅显示文字的核心原因可归纳为路径映射错误、资源加载失败和运行环境异常三类。建议按照配置检查→路径修正→权限验证→部署测试的流程排查问题，特别注意云服务器与本地环境的路径差异。通过规范部署流程和自动化脚本可有效避免此类问题。
本文由阿里云优惠网发布。发布者：编辑员。禁止采集与转载行为，违者必究。出处：https://aliyunyh.com/483073.html
其原创性以及文中表达的观点和判断不代表本网站。如有问题，请联系客服处理。
