主题
一键部署
项目生成完成后，你可以使用一键部署功能，将项目自动部署到你的本地电脑上运行。
仅支持 Windows
一键部署目前仅支持 Windows 系统，使用 PowerShell 脚本执行。macOS 和 Linux 用户需要手动部署。
操作步骤
第 1 步：点击一键部署
在任务详情页的顶部操作栏，点击"一键部署"按钮。
此按钮仅在项目生成完成且为代码项目时显示。
第 2 步：复制命令
弹出的对话框中会显示一条 PowerShell 命令，点击"复制命令"按钮。
第 3 步：打开 PowerShell
在 Windows 上，以管理员身份打开 Windows PowerShell：
- 按
Win + X，选择"Windows PowerShell（管理员）" - 或在开始菜单搜索"PowerShell"，右键选择"以管理员身份运行"
不要使用 CMD
必须使用 PowerShell，不要使用命令提示符（CMD）。CMD 不支持此命令。
第 4 步：粘贴命令并执行
在 PowerShell 中粘贴刚才复制的命令，按回车执行。
自动完成的工作
脚本执行后，会自动帮你完成以下所有步骤：
| 步骤 | 说明 |
|---|---|
| 下载项目 | 从云端下载你的项目代码并解压 |
| 安装运行环境 | 根据技术栈自动安装 Node.js / Java / Python |
| 安装数据库 | 自动安装并配置 MySQL 或 PostgreSQL（SQLite 无需安装） |
| 安装依赖 | 执行 pnpm install / mvn / uv sync 等 |
| 数据库迁移 | 自动创建表结构、导入种子数据 |
| 启动服务 | 在新窗口中启动前后端开发服务器 |
整个过程大约需要 5~15 分钟，取决于网络速度和项目复杂度。
部署完成后
脚本执行完成后，会显示：
- 前端访问地址：通常是
http://localhost:5173 - 后端 API 地址：通常是
http://localhost:3000 - 推荐的 IDE：根据技术栈推荐（VS Code / IntelliJ / PyCharm 等）
- 日志文件路径：排查问题时使用
打开浏览器访问前端地址，即可看到你的项目！
安全说明
- 命令内容完全透明，你可以在执行前查看脚本内容
- 依赖下载使用国内镜像源（如 npmmirror、阿里云 Maven 镜像等），下载速度快，无需额外配置
- 不会上传你的任何个人信息
国内镜像已内置
一键部署脚本已内置国内镜像源配置（npm 使用 npmmirror，Maven 使用阿里云镜像，pip 使用清华源等），无需手动配置镜像。如果手动部署，请参考对应技术栈文档配置镜像源。
关于命令分享
部署命令包含一个唯一的认证码，拥有此命令的人可以下载你的项目代码。请注意：
- 可以通过微信/QQ 发送给自己
- 不要分享给不相关的人
交付给学生
如果你是代做毕业设计的开发者，需要将项目交给学生使用，请按以下流程操作：
操作步骤
- 在你的电脑上完成项目生成和修改
- 生成完成后，点击任务详情页右上角的"一键部署"按钮
- 复制部署命令
- 将命令通过微信/QQ 发给学生
- 学生在自己的 Windows 电脑上以管理员身份打开 PowerShell，粘贴命令执行
关键提示
- 在你电脑上部署的项目只能在你的电脑上运行
- 学生需要在自己的电脑上执行部署命令
- 部署命令会自动下载代码并配置环境，学生无需编程基础
学生需要做的
- 收到部署命令后，在 Windows 上以管理员身份打开 PowerShell
- 粘贴命令并按回车
- 等待 5~15 分钟自动安装完成
- 安装完成后会自动打开浏览器显示项目
部署后如何修改代码
一键部署完成后，如果你想修改代码：
- 用 IDE（如 VS Code、IntelliJ）打开项目文件夹
- 像普通项目一样编辑代码
- 可以继续使用智码方舟的继续修改功能让 AI 帮你改，也可以自己手动修改
自由项目的部署
自由项目（安卓 App、单片机等）的部署方式略有不同：
- 安卓项目 → 使用 Android Studio 打开
- 单片机项目 → 使用 Keil 打开
- 其他类型 → 脚本会给出对应的操作指引
自由项目不会自动启动服务器，而是提供对应工具的打开建议。
常见问题
执行命令后报错"无法加载文件"
可能是 PowerShell 执行策略限制。命令已包含执行策略绕过，如果仍然报错，手动执行：
powershell
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass端口被占用
之前的进程没有关闭。可以修改项目配置使用其他端口，或者先关闭占用端口的进程。
数据库连接失败
检查数据库服务是否正常启动。脚本会自动启动数据库，但某些情况下可能需要手动启动。
解压失败
可能原因：
- 磁盘空间不足：确保 C 盘至少有 5GB 可用空间
- 杀毒软件拦截：暂时关闭 Windows Defender 或其他杀毒软件后重试
- 下载不完整：重新执行部署命令
Maven 报错 "No plugin found for prefix 'spring-boot'"
你执行命令的位置不对。使用一键部署脚本时，脚本会自动定位到正确目录。如果手动启动，请确保在包含 pom.xml 的项目根目录下执行。
后端启动报缺失依赖 / 依赖下载失败
一键部署脚本已内置国内镜像源。如果仍然下载失败，检查网络连接是否正常。手动部署请参考对应技术栈文档配置镜像源。
下一步
部署完成后，你可以：
- 试用项目：浏览各个功能，测试是否符合预期
- 继续修改：如果不满意，使用修改功能让 AI 调整
- 生成论文：基于项目代码自动生成毕业论文