GitHub教程：如何用Actions实现项目自动部署（零基础也能学）

每次改完代码都要手动传到服务器？改一次传一次，重复操作不说，还总担心传错文件？尤其是新手朋友，是不是觉得部署项目又麻烦又容易出错？今天兔子哥就来教大家一个偷懒的好办法 —— 用 GitHub Actions 实现自动部署，改完代码点个提交，后面的事情 GitHub 自动帮你搞定，零基础也能学会！

一、先搞明白：GitHub Actions 到底是个啥？

可能有朋友会问，Actions 听起来好高级，是不是很难学？其实一点都不复杂。简单说，GitHub Actions 就是 GitHub 自带的自动化工具，你可以把它理解成一个 “机器人”，你给它设定好规则（比如 “代码提交后自动打包”“打包完自动传到服务器”），它就会按照规则一步一步执行，不用你手动操作。
那自动部署又是啥意思呢？比如你做了个网页项目，以前可能要自己把代码压缩、然后通过 FTP 传到服务器上；用了自动部署后，你在 GitHub 上提交代码后，Actions 会自动帮你完成压缩、上传这些步骤，你喝口水的功夫，项目就更新好了。是不是很方便？

二、为什么新手也要学 Actions？这 3 个好处太实用了

可能有人觉得，我刚学编程，搞这些自动化的东西太早了吧？其实不然，Actions 对新手来说好处特别多：

• 省时间：不用再重复手动上传文件，提交代码后自动部署，省下的时间能多写两行代码
• 少出错：手动操作容易漏传文件、传错版本，自动化步骤固定，不容易出错
• 学经验：现在企业里都在用自动化部署，早点学会这个技能，以后找工作也加分

兔子哥自己刚开始学的时候也觉得麻烦，但用了一次就离不开了，真的能少走很多弯路。

---

三、实操开始：准备工作要做好

在开始之前，咱们得准备两样东西：

1. 一个 GitHub 仓库，里面放着你的项目代码（比如静态网页、Vue 项目这些都可以）
2. 一个可以部署项目的地方，新手推荐用 GitHub Pages（免费又简单），或者自己的服务器（需要知道服务器地址、账号密码）

这里咱们以部署到 GitHub Pages 为例，新手朋友跟着做，门槛最低。先确认你的仓库是公开仓库（私有仓库用 Pages 可能需要付费），然后把项目代码传到仓库里，这一步不会的朋友可以看我之前的仓库管理教程。

---

四、手把手教你：创建第一个 Actions 工作流文件

工作流文件就是告诉 Actions“该做什么、怎么做” 的规则表，咱们一步一步来创建：
第一步：打开你的 GitHub 仓库，点上方的 “Actions” 选项卡，第一次用会看到很多模板，不用管，点右边的 “set up a workflow yourself” 自己创建。
第二步：这时候会进入一个编辑页面，文件名默认是 “main.yml”，不用改名字，直接在编辑框里写规则。这里兔子哥给新手朋友准备了一个最简单的静态网页部署模板，直接复制进去就行：
yaml

name: Deploy to GitHub Pageson:push:branches: [ main ]  # 当main分支有提交时触发jobs:deploy:runs-on: ubuntu-latest  # 在Ubuntu系统上运行steps:- uses: actions/checkout@v4  # 拉取仓库代码- name: Deployuses: peaceiris/actions-gh-pages@v4  # 用别人做好的部署工具with:github_token: ${{ secrets.GITHUB_TOKEN }}  # 自动生成的令牌publish_dir: ./  # 部署当前目录的文件（根据你的项目改）

第三步：写完后点 “Start commit”，再点 “Commit new file” 保存，这样工作流文件就创建好了。

---

五、关键配置：让 Actions 有权限访问你的仓库

有朋友可能会问：Actions 凭什么能操作我的仓库？这就需要权限配置了，很简单：
在仓库页面点 “Settings”，然后点左边的 “Actions”→“General”，拉到 “Workflow permissions” 那里，选择 “Read and write permissions”（读写权限），最后点 “Save” 保存。这样 Actions 就有权限帮你部署项目了。

六、测试一下：看看自动部署能不能跑起来

配置完后咱们来测试一下，随便改一下项目里的文件（比如改改 index.html 里的文字），然后提交到 GitHub。这时候点仓库的 “Actions” 选项卡，会看到有一个工作流正在运行，状态显示 “yellow”（运行中）。
等几分钟，状态变成 “green”（成功）就说明部署完成了！这时候去你的 GitHub Pages 地址（仓库 Settings→Pages 里能看到）刷新一下，就能看到修改后的内容了，是不是很神奇？

---

七、常见问题：新手容易踩的坑和解决办法

刚开始用的时候，可能会遇到工作流失败的情况，别慌，兔子哥总结了几个常见问题：

问题现象	可能原因	解决办法
工作流一直失败，提示 “permission denied”	没开读写权限	去 Settings 里开启读写权限
部署后页面空白	publish_dir 路径错了	检查代码里的 publish_dir 是不是你的项目目录（比如 Vue 项目可能是./dist）
工作流没触发	分支名不对	检查 on.push.branches 是不是你提交代码的分支（比如你用的是 master 分支就改 master）

遇到问题先看工作流的日志（点失败的工作流，再点 “deploy” 步骤就能看到），日志里一般会告诉你哪里错了。

---

八、兔子哥的小建议：从简单开始，慢慢进阶

刚开始用 Actions 不用追求复杂功能，先把静态网页的自动部署跑通，熟悉了之后再尝试更复杂的项目（比如 React、Vue 项目）。另外，工作流文件可以多看看别人的模板（GitHub 上搜 “actions deploy example” 能找到很多），抄作业也是学习的好方法。
其实啊，自动化工具的核心就是 “解放双手”，刚开始可能觉得配置麻烦，但一旦跑通一次，后面就会越来越顺。现在很多企业都要求会用自动化部署工具，早点学会这个技能，不仅现在省时间，以后找工作也更有优势。
希望这篇教程能帮到想偷懒又想提高效率的你，跟着步骤多试两次，你会发现自动部署其实没那么难，赶紧去试试吧！

标签： 服务器 机器人