第 2 章
安装与启动
详细讲解如何安装项目依赖、配置环境和启动本地开发服务器。
本章详细介绍如何安装和启动本博客项目。
克隆项目
bash克隆仓库
git clone <your-repo-url> light-blog将 <your-repo-url> 替换为实际仓库地址
安装依赖
bash安装 npm 依赖
cd light-blog && npm install首次安装可能需要几分钟时间
启动开发环境
bash启动本地后台
npm run studio同时启动网站预览 (4321) 和管理控制台 (4322)
启动成功后将看到：
- 网站预览：
http://127.0.0.1:4321/ - Keystatic 后台：
http://127.0.0.1:4321/keystatic - 管理控制台：
http://127.0.0.1:4322/
示小贴士
如果端口被占用，可以在 package.json 中修改对应的端口号。
常见启动问题
端口 4321 已被占用
powershell查找并结束占用进程 (Windows)
netstat -ano | findstr :4321然后使用任务管理器或 taskkill /PID <pid> /F 结束该进程。
npm install 失败
- 确认 Node.js 版本满足要求
- 尝试清除缓存：
npm cache clean --force - 删除
node_modules和package-lock.json后重新安装
安装成功后，继续阅读下一章了解常见问题的解决方法。