内容摘要：jeecms 的安装包解压后，你会看到 db 和 tomcat 两个文件夹。别急着点 setup.exe，先把数据库配置改了。我见过太多人卡在第一步——默认的 MySQL 连接参数根本连不上你本地的库

jeecms 的教程安装包解压后，你会看到 db 和 tomcat 两个文件夹。教程别急着点 setup.exe，教程先把数据库配置改了。教程我见过太多人卡在第一步——默认的教程 MySQL 连接参数根本连不上你本地的库。打开 db 目录下的教程 jeecms.sql，用 Navicat 或者命令行导入，教程注意字符集选 utf8mb4，教程不然中文标题会变成问号。教程导入完成后，教程去 tomcat/webapps/ROOT/WEB-INF/config 里找 jdbc.properties，教程把用户名密码改成你自己的教程。这一步没做好，教程后面全是教程白搭。

启动 Tomcat 之前，教程检查一下端口。8080 被占用的概率不低，尤其是你电脑上装过其他 Java 项目。改 conf/server.xml 里的 Connector port，改成 8090 或者 8888 都行。启动脚本用 startup.bat（Windows）或 startup.sh（Linux），别双击 Tomcat 图标，那样看不到报错信息。命令行窗口里如果出现 “Server startup in xxx ms”，恭喜，基础环境通了。浏览器访问 http://localhost:端口，应该能看到默认首页。如果 404，去 logs 目录翻 catalina.out，大概率是数据库连不上或者表前缀不对。

后台入口是 /jeeadmin，默认账号密码都是 admin。第一次登录会强制你改密码，别偷懒设成 123456。进去之后左侧菜单栏里，“栏目管理” 和 “内容管理” 是使用频率最高的两个。我建议先建一个测试栏目，比如 “技术笔记”，模型选 “新闻”，然后发布一篇带图片的文章试试。图片上传路径默认在 /u/cms/www/upload 下面，如果你用 Nginx 做反向代理，记得把这个目录配成静态资源。有个坑：jeecms 的富文本编辑器对 Chrome 新版本支持一般，上传大图容易卡死，控制在 2MB 以内比较稳。

模板标签是 jeecms 的核心，也是新手最容易懵的地方。比如你要在首页循环输出文章列表，写法是 [@cms_content_list count='8' orderBy='4' titLen='20']，里面再套 [#list tag_list as a]。orderBy 的数值对应不同排序规则：1 是发布时间降序，4 是点击量降序。titLen 控制标题截取长度，中文算两个字符。这些参数在官方文档里写得零散，我一般直接翻 /WEB-INF/tags 下面的 cms_content_list.tag 文件，看默认值最快。改模板别在后台在线编辑，用 FTP 或者本地 IDE 改完再上传，不然缓存一开，改十遍都不生效。

缓存问题值得单独说。jeecms 默认开启页面缓存，你改了模板或者发了新文章，前台可能还是旧内容。去后台 “系统设置” 里找 “缓存管理”，点 “清除页面缓存”。如果还不行，重启 Tomcat。我自己的习惯是开发阶段直接在 config 里把 cache 相关参数设成 false，上线前再打开。另外，静态化功能慎用，除非你清楚生成规则，否则首页会变成一片空白——别问我怎么知道的。

最后提一句权限。jeecms 的角色管理粒度挺细，但别给普通编辑开 “栏目管理” 权限。他们误删一个栏目，底下所有文章都会变成孤儿数据。我习惯建两个角色：编辑只能发文章、传附件；管理员才碰模板和系统设置。数据库记得每天定时备份，用 mysqldump 写个 bat 脚本，扔到计划任务里。这套系统不算轻量，但摸清脾气之后，做个企业站或者新闻站还是够用的。