Skip to content

系统安装

安装环境

环境推荐版本说明
Php8.1+要求最低php8.1
Mysql5.7+
NodeJs22+推荐nvm安装Nodejs
Pnpmnpm install -g pnpm安装pnpm
Composer提前安装好Composer
Git提前安装好Git

安装步骤

⚠️建议

推荐在Git Bash终端中操作

1.克隆项目

# github
git clone https://github.com/himfkc/kucoder.git

# 如果github访问慢 可使用gitee
git clone https://gitee.com/himfkc/kucoder.git

2.安装kucoder后端

# 安装composer依赖
cd kucoder && composer install

# 环境变量 复制一份.env.example为.env
cp .env.example .env

# 启动redis 启动127.0.0.1:6379
本地启动redis

# 启动kucoder  启动127.0.0.1:8787 
# kucoder项目根目录执行以下命令
php windows.php start   # windows系统
php start.php start     # linux系统

3.安装vue依赖

# 安装vue依赖 需重新打开一个新的终端 
# kucoder项目根目录执行以下命令
cd vue-kc-admin && pnpm install

# 启动vue 启动localhost:9527
pnpm run dev

4.执行安装

# 访问以下页面执行安装 首次打开vue项目需要加载资源 请稍等....
http://localhost:9527/vue/admin/install

安装问题

如果文档解决不了你的问题 请到kucoder官网问题版块提问 去提问


  • git clone github地址时 速度特别慢或执行异常
  • 使用git clone gitee地址 替换github地址

  • 执行命令 cp .env.example .env时 报错 'cp' 不是内部或外部命令,也不是可运行的程序或批处理文件
  • 使用git bash终端代替windows的远程cmd来操作

  • 报错php扩展异常
  • php需要开启redis gd fileinfo zip sodium扩展

  • 启动kucoder报错redis未启动
  • kucoder默认使用redis 启动kucoder前 先启动redis

  • 执行pnpm install报错 pnpm未定义
  • 使用npm install -g pnpm安装pnpm