苹果CMS V10 的安装难度不高，新手卡住往往不是程序问题，而是环境与权限这类细节。本文按环境准备、上传、配置、向导的顺序走一遍，每一步都标出容易出错的点。
前置条件
安装前确认三样东西：一台已装好 Nginx + PHP + MySQL 环境的服务器，宝塔面板最省事，一键部署的操作流程可参考宝塔面板一键部署海洋CMS教程，界面与步骤相通；一份来自可靠渠道的苹果CMS V10 源码；一个已创建并授权的数据库，建库时字符集选 utf8mb4，避免后面出乱码问题。PHP 版本建议 7.x 档位，太新或太旧都可能踩兼容坑。另外建议提前建好数据库，而不是在向导里临时找入口，向导只负责填连接信息，不负责建库，这一步省掉能少踩不少坑。
上传与目录权限
把源码包上传到站点根目录解压，确认 runtime 等目录可写。目录权限不对是安装失败的第一大原因，表现为向导里环境检测不通过，或安装完成后首页报错。用宝塔的话，把站点目录所有者设为 www，关键目录给足写权限即可。解压后顺手检查一下目录里有没有来历不明的多余文件，非官方渠道的源码包要格外当心。
运行安装向导
浏览器访问站点域名，程序会自动跳转到安装向导。填数据库信息：地址、库名、用户名、密码，务必与建库时完全一致，这是第二大卡点，很多人在建库时勾了访问权限限制，向导里就连不上。管理后台账号密码设复杂一点，装完第一件事就是改默认后台路径。整个向导过程一分钟内可以走完，装完后续的主题配置可参考苹果CMS主题安装与切换教程。提交后程序会执行建表动作，看到安装成功的提示再进后台；中途报错就按提示回头核对数据库信息，不要反复刷新向导页面，容易留下不完整的表结构。
装完之后
安装完成只是开始。接下来依次：进后台绑定采集接口、配置伪静态、装一套像样的模板。新站上线前，建议过一遍新站上线15项检查清单（xinzhan-qingdan），把安全与 SEO 的基础项补齐。程序版本与环境的关系，可参考苹果CMS V10（maccmsv10）档案。
常见问题
四个高频问题：首页空白，多半是 runtime 目录不可写；数据库连接失败，九成是账号密码或库名填错；后台样式丢失，常见于伪静态没配好，路径规则可参考站内伪静态方案对比（wjingtai-fangan）；向导页直接 404，检查是否漏传了 public 目录或入口文件。程序本身的介绍可先读苹果CMS 词条（pingguocms）。排查任何报错前，先记下完整的提示信息再动手，半懂不懂地乱试，容易把简单问题折腾成复杂问题。
相关词条：苹果CMS、苹果CMSV10、新站上线15项检查清单