Aloys23 Blog

Gitea项目协作功能介绍

Mon, 01 Jun 2026 00:00:00 GMT

前言

前面几篇文章主要在讲Git本身：

怎么配置Git和Gitea
怎么提交代码
多人协作怎么走Pull Request
遇到冲突怎么处理

到这里，基本已经能做到：

clone -> 开发 -> commit -> push -> Pull Request -> merge

但真正做项目协作时，只会这些还不够。

很多人会clone、会push、会创建Pull Request，但是看到仓库里的这些功能就不知道是干什么的：

Issue（工作项）
Milestone（里程碑）
Label（标签）
Project（项目）
Wiki（项目文档）
Release（版本发布）

这些功能看起来像是附加功能，实际上它们才是项目协作里很重要的一部分。

Git解决的是“代码怎么管理”，而Gitea这些功能解决的是：

事情怎么记录
任务怎么分配
进度怎么跟踪
版本怎么发布
文档放在哪里

这篇就从这些常见功能开始，讲一下Gitea里一个项目到底应该怎么协作。

Issue（工作项）

先讲Issue，因为这是最重要的。

很多人会把Issue翻译成“问题”，但这样容易理解窄了。

更准确地说：

Issue = 一条工作记录

它可以是很多东西：

Bug
功能需求
优化建议
待办任务
文档补充
讨论事项

比如：

修复登录失败问题
增加深色模式
优化首页加载速度
补充部署文档
调整用户权限逻辑

这些都可以创建成Issue。

如果没有Issue，团队协作很容易变成这样：

微信群里说了一句
过几天没人记得
谁负责也不知道
做没做完也不知道

有了Issue以后，每一件事都有一个记录，可以看到是谁提的、谁负责、现在做到哪一步、最后怎么解决的。

创建Issue（工作项）

在Gitea仓库页面里，一般可以进入Issues页面，然后点击New Issue创建。

创建Issue时，主要看这几项：

标题
描述
指派人
标签
里程碑

标题要简短明确，不要只写“有问题”“修一下”“报错了”。

比如下面这种标题就不太好：

登录有问题

可以写得更具体一点：

修复密码错误时登录页面没有提示的问题

描述里可以写清楚：

现在是什么现象
期望应该是什么样
怎么复现
有没有截图或日志
影响范围大不大

Bug类Issue可以这样写：

### 问题描述

用户输入错误密码后，页面没有显示错误提示。

### 复现步骤

1. 打开登录页面
2. 输入已存在账号
3. 输入错误密码
4. 点击登录

### 期望结果

页面提示“账号或密码错误”。

### 实际结果

页面没有任何提示。

功能需求可以这样写：

### 需求说明

希望增加考试成绩导出功能，管理员可以导出某场考试的成绩表。

### 需要包含

- 学生姓名
- 学号
- 分数
- 提交时间

### 备注

第一版可以先支持导出 CSV。

写清楚Issue，其实就是减少后面沟通成本。

Issue（工作项）的生命周期

一个Issue通常会经历这样的过程：

Open
↓
分配负责人
↓
处理中
↓
提交 Pull Request
↓
Review
↓
合并
↓
关闭

刚创建出来的Issue一般是Open状态，表示这个事情还没有完成。

处理完成后，可以手动关闭，也可以在Pull Request合并时自动关闭。

比如在PR描述里写：

Closes #12

这个PR合并后，编号为#12的Issue就会自动关闭。

如果只是关联Issue，不想自动关闭，可以写：

Related to #12

这样别人看PR时，就能知道这次代码修改和哪个Issue有关。

Label（标签）

Label就是标签，用来给Issue或Pull Request分类。

常见标签有：

bug
enhancement
documentation
question
help wanted

大概可以这样理解：

bug：程序问题
enhancement：功能增强或优化
documentation：文档相关
question：问题或讨论
help wanted：需要别人帮忙

标签的作用不是装饰，而是方便筛选。

比如你只想看所有Bug，就可以筛选bug标签；只想看文档任务，就筛选documentation。

项目大一点后，如果所有Issue都没有标签，列表会很乱。

一个比较简单的标签体系可以这样：

bug
feature
docs
ui
backend
priority-high
priority-low

刚开始不用设计得太复杂，够用就行。标签太多没人维护，最后也会变成摆设。

Assignee（负责人）

Assignee就是负责人。

一个Issue创建出来以后，如果没人负责，它很容易被放在那里没人处理。

比较好的做法是：

Issue
↓
指定给张三
↓
张三负责跟进

被指派的人不一定要一个人完成所有代码，但至少要负责推进这件事。

比如：

确认需求
写代码
找人Review
更新进度
最后关闭Issue

如果一个Issue暂时没人处理，可以先不指派。但只要进入开发阶段，最好明确负责人。

Milestone（里程碑）

Milestone是里程碑。

这个功能很多人不太会用，因为它不像Issue那么直观。

可以简单理解成：

Milestone = 一个版本或阶段的目标集合

比如：

v1.0
v1.1
v2.0

一个版本通常不只包含一个任务，而是包含多个Issue。

例如v1.1这个里程碑里可能有：

修复登录失败问题
增加深色模式
优化首页加载速度
补充部署文档

这些Issue都完成后，v1.1这个里程碑才算完成。

所以Milestone适合回答这个问题：

这个版本还有哪些事情没做完？

如果只是个人小项目，不用Milestone也能写。但只要项目开始有版本计划，比如v1.0、v1.1，Milestone就很有用了。

Project（项目看板）

Project可以理解成项目看板，类似常见的Kanban。

最简单的看板一般有三列：

TODO
↓
Doing
↓
Done

也可以写成中文：

待办
↓
进行中
↓
已完成

Issue可以放到看板里，然后随着进度移动。

比如一个任务刚提出来时，放在TODO；有人开始处理后，移动到Doing；完成并合并后，移动到Done。

Project适合回答这个问题：

现在大家都在做什么？
哪些任务还没开始？
哪些任务已经完成？

如果只看Issue列表，有时不太直观。Project看板能让进度一眼看出来。

刚开始可以只建一个简单看板：

TODO
Doing
Done

不要一开始就搞太多列，比如“需求池”“待评审”“开发中”“测试中”“待发布”“已发布”。流程太复杂，反而没人愿意维护。

Pull Request（合并请求）

Pull Request前面已经单独讲过，这里简单串一下。

在Gitea项目协作里，Pull Request通常不是孤立存在的。

更完整的流程应该是：

Issue
↓
开发
↓
Pull Request
↓
Review
↓
Merge
↓
关闭 Issue

也就是说，PR最好能对应某个Issue。

比如有一个Issue：

#12 添加考试成绩导出功能

开发者创建PR时，可以在描述里写：

Closes #12

这样PR合并后，Issue会自动关闭，整个任务链路就完整了。

如果一个PR没有对应Issue，也不是绝对不行。比如很小的文案修改、临时修复，可以直接PR。但对于稍微复杂一点的功能，先有Issue再有PR会更清楚。

Wiki（项目文档）

Wiki适合放项目文档。

很多人会把所有东西都写进README.md，刚开始没问题，但项目复杂后，README会越来越长。

这时可以把一些长期文档放到Wiki里，比如：

部署文档
开发规范
接口文档
数据库说明
常见问题
环境变量说明

README更适合放项目简介、快速开始、常用链接。

Wiki更适合放详细说明。

比如一个后端项目，可以在Wiki里建这些页面：

本地开发环境
生产环境部署
接口鉴权说明
数据库迁移说明
常见报错处理

如果团队里经常有人问“这个项目怎么启动”“接口文档在哪”“部署命令是什么”，那就说明这些内容应该沉淀到Wiki里。

Release（版本发布）

Release是发布版本。

它不是简单地给源码打个包，而是用来记录某个版本发布了什么。

常见版本号大概是：

v1.0.0
v1.1.0
v1.2.0

发布Release时，可以做这些事：

写更新日志
上传二进制文件
记录版本变更
标记这个版本对应的代码

比如一个v1.2.0版本可以这样写：

## v1.2.0

### 新增

- 添加考试成绩导出功能
- 添加管理员操作日志

### 修复

- 修复登录失败时没有错误提示的问题
- 修复部分页面刷新后状态丢失的问题

### 优化

- 优化首页加载速度

这样以后回头看，就知道每个版本到底改了什么。

如果项目会提供可执行文件，比如桌面软件、命令行工具、服务端程序，也可以把编译好的文件上传到Release里。

Release适合回答这个问题：

这个版本发布了什么？
用户应该下载哪个文件？
出了问题应该回退到哪个版本？

Watch（关注）、Star（收藏）、Fork（复制仓库）

如果你用过GitHub，这几个功能会很熟悉。Gitea里也有类似概念。

Star可以理解成收藏或点赞。

它一般表示：

我觉得这个项目有用，先收藏一下。

Watch是关注更新。

如果你Watch了一个仓库，仓库有新Issue、Pull Request、Release等更新时，可能会收到通知。

Fork是复制仓库。

它会把别人的仓库复制一份到你的账号下面。你可以在自己的副本里修改代码，然后再向原仓库提交Pull Request。

简单区分：

Star：收藏项目
Watch：关注更新
Fork：复制一份仓库用于修改

同一个团队内部开发，一般直接在原仓库开分支就行。

如果你没有原仓库的写权限，比如给开源项目贡献代码，通常就先Fork，再提交Pull Request。

一个完整例子

前面每个功能单独看可能有点散，下面用一个“在线考试系统”的例子串起来。

假设现在要做一个新功能：

添加考试成绩导出功能

比较完整的协作流程可以是：

创建 Issue：添加考试成绩导出功能
↓
添加 Label：feature、backend
↓
加入 Milestone：v1.2.0
↓
分配给开发者
↓
放入 Project 看板 TODO
↓
开发者开始处理，移动到 Doing
↓
创建 feature-export 分支
↓
提交代码
↓
创建 Pull Request
↓
关联 Issue：Closes #12
↓
Code Review
↓
合并 PR
↓
Issue 自动关闭
↓
Project 卡片移动到 Done
↓
发布 Release：v1.2.0

这样一条线下来，每一步都有记录。

别人想知道这个功能为什么做，可以看Issue。

想知道谁负责，可以看Assignee。

想知道属于哪个版本，可以看Milestone。

想知道现在进度，可以看Project。

想知道代码怎么改的，可以看Pull Request。

想知道最终发到哪个版本，可以看Release。

这就是Gitea项目协作功能的意义。

建议的学习顺序

如果按这个系列来看，可以这样排：

1. Gitea与Git配置
2. Git基础使用教程
3. Git协作流程
4. Git冲突处理
5. Gitea项目协作功能介绍
6. Gitea组织与权限管理
7. Gitea Actions使用
8. Gitea部署记录

前几篇解决的是“会不会用Git提交代码”。

从这篇开始，就进入“会不会管理项目协作”。

一个人写代码时，可能Issue、Milestone、Project这些东西都显得可有可无。但只要项目里有多人协作、有版本计划、有任务分配，这些功能就会变得很有用。

总结

Gitea不只是一个放代码的地方。

如果只用它来clone、push、创建Pull Request，那其实只用到了一部分能力。

更完整的项目协作应该是：

Issue 记录事情
Label 分类任务
Assignee 明确负责人
Milestone 管理版本目标
Project 跟踪任务进度
Pull Request 合并代码
Wiki 沉淀文档
Release 发布版本

先不用一上来把所有功能都用得很复杂。

小团队可以先从三个东西开始：

Issue
Pull Request
Release

等任务多了，再加Label、Milestone和Project。这样从“会写代码”慢慢过渡到“会管理项目”，协作会清楚很多。

Git冲突处理

Mon, 01 Jun 2026 00:00:00 GMT

前言

上一篇文章Git协作流程介绍了多人协作时，一个功能从开发到合并的大致流程。

真正写项目时，最容易让人头疼的往往不是提交代码，而是各种异常情况：

pull冲突
merge冲突
push被拒绝
提交错了
分支搞乱了
改了一半代码但突然要切分支

这些问题刚遇到时会很吓人，尤其是终端里突然出现一堆英文提示，很容易不知道下一步该敲什么。

这篇就不讲太多Git原理了，主要记录一些常见问题的处理方法。目标很简单：遇到问题时，知道先看什么，再执行什么命令。

为什么会产生冲突

先看一个最常见的场景：

你修改 login.js
↓
同事也修改 login.js
↓
你执行 git pull
↓
Git 无法自动决定保留哪份代码
↓
产生冲突

Git能自动合并很多修改。

比如你改了login.js，同事改了README.md，这两个文件互不影响，Git一般能自动合并。

再比如你和同事都改了login.js，但你改的是第10行，同事改的是第80行，Git大多数时候也能自动合并。

真正容易冲突的是：

同一个文件
同一个位置
被不同人改了不同内容

这时Git不知道应该保留你的版本，还是保留同事的版本，所以它会停下来，让你手动处理。

冲突本身不是Git坏了，而是Git不敢替你乱选。

merge冲突

假设你在main分支，想把feature-login分支合并进来：

git merge feature-login

如果两边修改了同一个位置，可能会看到类似提示：

CONFLICT (content): Merge conflict in login.js
Automatic merge failed; fix conflicts and then commit the result.

这时先不要慌，先看状态：

git status

git status会告诉你哪些文件处于冲突状态。

打开冲突文件后，一般会看到这种内容：

<<<<<<< HEAD
本地内容
=======
另一分支内容
>>>>>>> feature-login

这里的含义是：

<<<<<<< HEAD到=======之间，是当前分支的内容
=======是分隔线
=======到>>>>>>> feature-login之间，是待合并分支的内容
>>>>>>> feature-login表示这些内容来自feature-login

处理冲突时，不是简单删除某一边就完事，而是要根据实际需求改成最终正确的代码。

处理步骤一般是：

打开冲突文件
删除<<<<<<<、=======、>>>>>>>这些冲突标记
保留或合并正确内容
保存文件
重新加入暂存区
提交合并结果

命令是：

git add login.js
git commit

如果有多个冲突文件，就都处理完后再git add：

git add 文件1 文件2
git commit

pull为什么会冲突

很多人会觉得奇怪：

git pull

不是拉代码吗，为什么也会冲突？

原因是git pull并不是单纯下载代码，它本质上等于：

git pull = git fetch + git merge

也就是说，git pull会先把远程的新提交下载下来，然后再把远程分支合并到你当前分支。

既然它内部做了merge，那当然也可能产生merge冲突。

所以遇到pull冲突时，处理方式和merge冲突基本一样：

git status
# 手动修改冲突文件
git add 冲突文件
git commit

如果你不确定哪些文件冲突了，永远先看：

git status

这个命令会告诉你当前Git卡在哪一步。

rebase冲突

有些团队或个人习惯用rebase来同步代码，比如：

git pull --rebase

或者：

git rebase main

rebase也可能冲突。

冲突文件里的标记看起来也差不多，还是这种形式：

<<<<<<< HEAD
当前内容
=======
你的提交内容
>>>>>>> 提交ID

处理文件的方式一样：打开文件，删掉冲突标记，改成最终正确内容。

不同的是，rebase处理完冲突后，不是执行git commit，而是：

git add 文件名
git rebase --continue

如果后面还有冲突，就继续处理，再继续：

git add 文件名
git rebase --continue

如果这次rebase越处理越乱，想放弃，可以：

git rebase --abort

这个命令会取消本次rebase，回到rebase之前的状态。

简单记：

merge 冲突解决完：git add -> git commit
rebase 冲突解决完：git add -> git rebase --continue

push被拒绝

推送时看到这种提示也很常见：

failed to push some refs

或者提示远程分支比本地更新。

常见原因是：

远程仓库已经有新提交
但你本地还没有这些提交
所以Git拒绝直接推送

比如你和同事都在同一个分支上开发。同事先推送了代码，你本地还没拉取他的提交，这时你直接git push，Git就可能拒绝。

比较常见的解决方式是：

git pull --rebase
git push

意思是先把远程的新提交拿下来，再把你的提交放到后面，然后重新推送。

如果git pull --rebase过程中出现冲突，就按前面rebase冲突的方式处理：

git status
# 手动修改冲突文件
git add 文件名
git rebase --continue
git push

不要一看到push失败就立刻强制推送。强制推送可能会覆盖别人已经推上去的提交，尤其是在公共分支上很危险。

临时保存修改

有时你代码写到一半，突然要切到别的分支修bug。

这时如果直接切分支，Git可能会提示：

Please commit your changes or stash them before you switch branches.

意思是：你当前还有未提交修改，先提交或者临时保存起来。

如果这些代码还没写完，不适合提交，可以用stash临时保存。

保存当前修改：

git stash

查看保存列表：

git stash list

恢复最近一次保存：

git stash pop

pop会恢复修改，并把这条stash记录从列表里删除。

如果只想恢复但保留stash记录，可以用：

git stash apply

删除某条stash：

git stash drop

如果有多条stash，可以指定名字：

git stash pop stash@{0}
git stash drop stash@{0}

stash适合临时救急，不建议长期把重要代码放在里面。重要修改最好还是及时提交到分支上。

撤销未提交的修改

如果文件改坏了，还没有提交，可以用restore恢复。

恢复单个文件：

git restore 文件名

恢复当前目录下所有未提交修改：

git restore .

注意，这个操作会丢失工作区修改。

执行前最好先看一下：

git diff

确认这些修改真的不要了，再执行restore。

取消暂存

如果文件已经git add了，但还没commit，想把它从暂存区拿出来：

git restore --staged 文件名

这个命令只是取消暂存，不会删除文件内容。

比如你执行了：

git add .

结果发现把不该提交的文件也加进去了，就可以：

git restore --staged 文件名

然后重新选择真正要提交的文件。

回退提交

如果已经提交了，但发现提交错了，可以用reset。

先查看提交历史：

git log --oneline

比如最近一次提交写错了，想撤销这个commit，但代码还想保留：

git reset --soft HEAD~1

--soft的意思是：

撤销 commit
保留代码修改
保留暂存状态

如果想撤销提交，并且让修改回到未暂存状态，可以用：

git reset --mixed HEAD~1

--mixed是git reset默认模式，通常可以不写。

最危险的是：

git reset --hard HEAD~1

它的意思是：

撤销 commit
代码修改也一起删除

所以--hard一定要慎用。执行前最好确认这次提交里的代码真的不要了。

如果提交已经推送到远程，并且别人可能已经基于它继续开发，就不要随便reset --hard再强推，这很容易影响别人。

使用revert撤销提交

多人协作时，更推荐用revert撤销已经提交的内容。

命令是：

git revert 提交ID

revert和reset的区别可以简单理解成：

reset：把历史往回挪
revert：新增一个反向提交

比如某个提交添加了三行代码，revert会生成一个新的提交，把这三行代码删掉。

它不会删除历史记录，所以更适合多人协作。

简单建议：

自己本地还没推送的提交，可以考虑reset
已经推送到远程的提交，优先考虑revert
公共分支上不要随便reset --hard

reflog：Git的后悔药

如果你误删了提交，或者reset过头了，可以先看reflog。

git reflog

输出大概像这样：

abc123 HEAD@{0}: reset: moving to HEAD~1
def456 HEAD@{1}: commit: 添加登录页面

git log主要看当前分支能看到的提交历史。

git reflog记录的是HEAD移动过的位置。很多误操作之后，提交虽然从普通日志里看不到了，但还能在reflog里找到。

找到想恢复的提交ID后，可以：

git reset --hard def456

注意，reset --hard会让当前代码回到那个提交对应的状态，执行前确认工作区没有要保留的修改。

如果不想直接回退，也可以先新建一个分支保住现场：

git switch -c recover-branch def456

这样更稳一点。

强制推送

强制推送命令是：

git push --force

它的风险很大，因为它可能覆盖远程分支历史。

比如远程分支上有同事刚推送的提交，你本地没有这些提交，直接--force可能会把同事的提交顶掉。

如果确实需要强制推送，更推荐：

git push --force-with-lease

简单理解：

--force：直接用本地历史覆盖远程历史
--force-with-lease：如果远程分支被别人更新过，就拒绝覆盖

--force-with-lease不是完全没有风险，但比--force更安全。

日常建议：

自己的功能分支，确认没人共用时，可以谨慎使用
公共分支，比如main、develop，不要随便强推
不确定时，先问团队成员，不要直接覆盖远程

常见问题

commit说明写错了怎么办

如果只是最近一次提交说明写错了，还没推送，可以：

git commit --amend

它会修改最近一次提交。

也可以直接写新说明：

git commit --amend -m "新的提交说明"

如果这个提交已经推送到远程，修改后通常需要强制推送。多人协作时要谨慎。

push到错误分支怎么办

先不要继续操作，先确认当前分支和提交历史：

git branch
git log --oneline

如果只是把提交推到了自己的错误分支，可以把正确提交cherry-pick到目标分支，再在错误分支上用revert撤销。

如果推到了公共分支，建议不要自己直接reset --hard加push --force，先和团队确认处理方式。

删除错分支怎么办

如果只是删除了本地分支，可以先用reflog找提交：

git reflog

找到提交ID后重新建分支：

git switch -c 分支名 提交ID

如果远程分支还在，也可以直接重新拉：

git fetch origin
git switch -c 分支名 origin/分支名

reset过头了怎么办

先看：

git reflog

找到reset之前的提交ID，然后恢复：

git reset --hard 提交ID

如果当前工作区还有想保留的修改，不要立刻--hard，可以先stash或者新建分支保存现场。

merge和rebase冲突有什么区别

冲突文件的处理方式差不多，都是：

打开文件
删除冲突标记
保留正确内容
git add

区别在最后一步：

merge 冲突：git commit
rebase 冲突：git rebase --continue

如果不想继续：

git merge --abort
git rebase --abort

分别用于取消当前的merge或rebase。

总结

遇到Git冲突时，可以先按这条线处理：

冲突
↓
git status
↓
编辑冲突文件
↓
git add
↓
git commit / git rebase --continue

不要一看到冲突就乱敲命令。先用git status看清楚Git现在卡在哪一步，再决定是commit、rebase --continue，还是abort。

常见场景可以记这个表：

场景	命令
查看状态	`git status`
临时保存	`git stash`
恢复修改	`git restore 文件名`
取消暂存	`git restore --staged 文件名`
回退提交	`git reset`
安全撤销	`git revert 提交ID`
查看历史	`git log --oneline`
找回误删提交	`git reflog`
继续rebase	`git rebase --continue`
取消rebase	`git rebase --abort`

Git很多问题看起来吓人，其实大部分都有固定处理流程。只要提交前多看status和diff，公共分支上少用危险命令，出了问题先别急着强推，基本都能处理回来。

Git协作流程

Mon, 01 Jun 2026 00:00:00 GMT

前言

上一篇文章Git基础使用教程写了Git的基础命令，比如add、commit、branch、merge、rebase这些东西。

这篇主要记录多人协作时最常见的一套流程。

重点不是讲很多高级命令，而是搞清楚一件事：

一个功能从开始开发，到最后合并进主分支，中间到底经过哪些步骤。

如果只是自己一个人写代码，可能本地改完、提交、推送就结束了。但多人一起改同一个项目时，就不能每个人都直接往主分支上推代码了，不然很容易互相覆盖、互相冲突，最后谁也不知道主分支到底还能不能正常运行。

为什么不要直接改main

main或者以前常见的master，一般代表项目当前比较稳定的代码。

比如一个网站项目，main分支上的代码可能会直接部署到线上；一个后端项目，main分支可能就是大家默认拉取和测试的版本。

如果所有人都直接在main上开发，会出现几个问题：

代码还没写完就被别人拉到了
一个半成品功能影响其他人开发
出了问题很难判断是哪次修改引起的
没有机会让别人提前检查代码

所以多人协作时，更常见的做法是：

main 保持稳定
每个人在自己的分支上开发
写完后通过 Pull Request 合并回 main

这样主分支不会被随便改动，每个功能也有比较清楚的开发和检查过程。

常见协作流程

平时协作大概可以按这条线走：

更新主分支
↓
创建功能分支
↓
开发并提交
↓
推送到远程
↓
创建 Pull Request
↓
代码检查 / Review
↓
合并到 main
↓
删除功能分支

看起来步骤不少，但实际熟悉之后就是一套固定动作。

简单说，就是不要把代码直接写到main，而是先从最新的main拉出一个自己的功能分支。功能写完以后，把这个分支推送到远程仓库，再创建一个Pull Request，让别人看一下改了什么，确认没问题后再合并。

开发前先更新主分支

开始写新功能前，先切回main，把远程最新代码拉下来。

git switch main
git pull

这一步是为了保证自己的新分支是从最新代码上分出来的。

如果你本地的main已经落后远程很多，直接从旧代码上开分支，后面更容易遇到冲突。

创建自己的功能分支

更新完main后，再创建自己的功能分支。

git switch -c feature-login

-c表示创建并切换到这个新分支。

分支名最好能看出来这个分支是干什么的，不要随便叫test、aaa、new这种名字。

常见命名方式：

feature/login
fix/login-error
docs/update-readme

大概可以这样理解：

feature/xxx：开发新功能
fix/xxx：修复问题
docs/xxx：修改文档

团队里如果有固定命名规范，就按团队规范来。没有规范时，至少保证别人能从分支名看懂大概用途。

在分支上开发和提交

切到功能分支后，就可以正常改代码了。

改完一部分后，可以先看状态：

git status

确认这次要提交哪些文件：

git add .
git commit -m "添加登录页面"

这里还是建议养成几个习惯：

提交前先看git status
一个提交尽量只做一件事
不要把临时文件、测试文件、编译产物误提交上去
提交说明不要只写update

比如下面这种提交说明就比较难看懂：

git commit -m "update"

过几天再看日志，根本不知道这个update到底更新了什么。

可以写得具体一点：

git commit -m "添加登录页面"
git commit -m "修复登录失败提示"
git commit -m "更新登录接口地址"

提交说明不一定要特别长，但至少要让人知道这次提交主要做了什么。

推送分支到远程

本地提交完成后，需要把自己的功能分支推送到远程仓库。

第一次推送这个分支时，一般这样写：

git push -u origin feature-login

这里的-u是设置上游分支。设置之后，以后在这个分支上再推送，就可以直接：

git push

如果分支名是feature/login，命令就是：

git push -u origin feature/login

推送成功后，远程仓库里就能看到这个分支了，接下来就可以创建Pull Request。

创建Pull Request

Pull Request可以简单理解成：

我这个分支写好了，请帮我看一下，没问题就合并到 main。

如果使用的是Gitea，大概流程是：

打开仓库页面
选择Pull Requests
点击New Pull Request
base(左侧的)选择main
compare(右侧的)选择自己的功能分支
填写标题和说明
提交Pull Request

创建PR时，最重要的是确认方向不要选反。

一般应该是：

base: main
compare: feature-login

意思是把feature-login分支的修改合并到main。

Pull Request里应该写什么

PR不要只写一个标题就提交。别人Review时，需要快速知道你改了什么、怎么测试、有没有需要注意的地方。

可以按这个模板写：

### 修改内容

- 添加登录页面
- 添加登录接口调用
- 修改路由配置

### 测试情况

- 本地启动正常
- 登录成功和失败都测试过

### 注意事项

- 暂时没有接入验证码

如果项目有自动化测试，也可以写测试命令是否通过：

### 测试情况

- pnpm build 通过
- pnpm test 通过
- 本地手动测试登录成功和失败场景

PR说明不用写成作文，但要让别人不打开代码也能先知道这次改动的大概范围。

Code Review是什么

Code Review就是别人帮你看代码。

这不是找茬，也不是为了证明谁水平高，而是为了在代码合并前尽量减少问题。

Review时一般会看这些东西：

有没有明显bug
代码风格是否统一
有没有误提交文件
有没有安全问题
功能是否符合需求
命名和目录位置是否合适
有没有影响到其他功能

比如你写登录功能时，不小心把本地测试地址、密码、.env文件提交上去了，自己可能没注意，但Review的人可能一眼就能看出来。

再比如一个功能能跑，但写法和项目里其他地方完全不一样，后面维护的人就会很难受。Review可以提前把这些问题拦下来。

有人改了main怎么办

多人协作时，你开发自己的功能期间，别人可能已经往main合并了新的代码。

这时你的功能分支就落后了。

可以在功能分支上同步最新的main：

git switch feature-login
git fetch origin
git rebase origin/main

也可以简单一点：

git pull --rebase origin main

个人功能分支用rebase通常会比较清爽，因为它会把你的提交放到最新的main后面，历史看起来更像一条直线。

大概可以理解成：

先把 main 的新提交拿过来
再把自己的提交重新放到后面

不过要注意，rebase更适合自己的功能分支。已经给很多人共同使用的公共分支，不建议随便rebase，否则容易影响别人。

发生冲突怎么办

如果你和别人改了同一个文件的同一部分，就可能出现冲突。

比如执行rebase时提示冲突，可以先看状态：

git status

然后打开冲突文件，手动处理里面的冲突内容。处理完成后：

git add 冲突文件
git rebase --continue

如果冲突太乱，暂时不想继续，也可以取消这次rebase：

git rebase --abort

冲突本身不是什么可怕的东西，它只是Git不知道该保留哪一边，需要人来判断。

处理冲突时不要只想着“让文件不报错”，还要确认功能逻辑是不是对的。尤其是两个人同时改了同一个函数、同一个配置文件时，解决完最好重新跑一下项目。

合并Pull Request

PR通过Review后，就可以合并到main。

常见合并方式有几种：

Create merge commit
Squash and merge
Rebase and merge

Create merge commit会保留分支上的提交记录，并额外生成一个合并提交。小团队、小项目直接用这个也没问题。

Squash and merge会把这个PR里的多个提交压成一个提交再合并。如果你开发过程中提交了很多零碎记录，比如fix、debug、update，用squash可以让main的历史更干净。

Rebase and merge会把功能分支上的提交重新放到main后面，历史也比较直，但对新手来说理解成本稍微高一点。

入门时可以先记一个简单建议：

小项目可以直接merge；想让历史干净，可以squash。

如果团队已经规定了合并方式，就按团队规则来。

合并后删除分支

功能已经合并进main后，原来的功能分支通常就可以删掉了。

远程分支可以在Gitea的PR页面里删除，一般合并后页面会有删除分支的按钮。

本地分支可以这样删：

git switch main
git pull
git branch -d feature-login

git branch -d会删除本地分支。如果Git发现这个分支还没有合并，通常会拒绝删除，避免误删。

如果你用的是feature/login这种分支名，就写：

git branch -d feature/login

删分支不是删代码，因为代码已经合并到main里了。删除的是这个开发任务用完后的临时分支。

常见问题

为什么我push到main被拒绝

可能是主分支保护。

很多团队会禁止普通成员直接推送到main，只能通过Pull Request合并。这样可以避免没有Review的代码直接进入主分支。

遇到这种情况，不要强行改权限，应该新建功能分支，再通过PR提交。

为什么PR不能合并

常见原因有几个：

有冲突没有解决
自动检查没有通过
没有合并权限
PR方向选错了
需要至少一个人Review通过

可以先看PR页面上的提示。一般Gitea、GitHub、GitLab都会告诉你当前卡在哪一步。

merge和rebase到底选哪个

简单记：

公共分支少rebase
自己的功能分支可以rebase
不确定就merge

merge更直观，也更不容易影响别人。rebase能让历史更清爽，但前提是你知道自己在改哪条分支。

刚开始协作时，不需要一上来就追求特别漂亮的提交历史，先保证流程正确、代码别丢、主分支稳定更重要。

fork和branch有什么区别

branch是在同一个仓库里开分支，适合同一个团队内部协作。

fork是把别人的仓库复制一份到自己的账号下面，适合外部贡献者参与项目。

简单说：

同一个团队仓库一般用 branch
外部贡献一般用 fork

比如公司内部几个人一起开发一个项目，通常直接在项目仓库里建分支。

如果你想给一个开源项目贡献代码，但你没有那个仓库的写权限，就先fork到自己账号，再从自己的仓库提交PR。

总结

日常协作可以记住这条线：

main 拉最新 -> 新建分支 -> 提交 -> 推送分支 -> PR -> Review -> 合并

这篇的核心不是某一个单独命令，而是完整流程。

不要直接在main上开发。功能分支写完后，通过Pull Request合并，这样代码历史更清楚，主分支更稳定，也更适合多人协作。

Git基础使用教程

Thu, 28 May 2026 00:00:00 GMT

前言

上一篇文章Gitea与Git配置主要写了Gitea和Git的配置，比如安装Git、配置用户名邮箱、生成SSH密钥、连接远程仓库等。

这篇文章就不继续折腾SSH了，主要讲Git最基础的一套使用流程。

很多人刚开始用Git时，基本只会三板斧：

git clone
git pull
git push

能用，但是一到自己改代码、提交代码、推送代码时就容易乱。比如：

add到底是干什么的
commit是不是已经上传了
为什么提交前要看status
为什么pull有时会冲突
哪些文件不应该提交上去

所以这篇不打算把Git所有命令都讲一遍，只围绕一个最常见的问题：

我改完代码以后，怎么正确提交并推送到远程仓库？

先记住一条线

Git日常使用可以先记住这条线：

工作区 -> git add -> 暂存区 -> git commit -> 本地仓库 -> git push -> 远程仓库

这条线看懂了，add、commit、push就没那么容易混。

工作区就是你正在编辑的项目目录。你用VS Code改了文件，这些改动一开始都在工作区里。

git add是把准备提交的内容放进暂存区。暂存区可以理解成“这次准备提交的清单”。

git commit是把暂存区里的内容保存成一次本地提交。

git push才是把本地提交上传到Gitea、GitHub这类远程仓库。

所以一定要记住：

commit = 本地存档
push = 上传远程

很多新手会以为自己commit以后别人就能看见，其实不是。只commit不push，代码还在自己电脑里。

一套最常用的日常流程

平时改完代码后，可以按这个顺序来：

git status
git diff
git add .
git commit -m "提交说明"
git pull
git push

简单解释一下：

git status：先看当前有哪些文件改了
git diff：再看具体改了什么
git add .：把要提交的内容放进暂存区
git commit -m "提交说明"：提交到本地仓库
git pull：推送前先拉一下远程最新代码
git push：把本地提交推送到远程仓库

后面就按这条线展开讲。

第一步：先看状态

不知道下一步该干什么时，先敲：

git status

git status会告诉你几件事：

当前在哪个分支
哪些文件改了
哪些文件已经add了
哪些文件还没有被Git跟踪

比如看到文件在Changes not staged for commit下面，说明这个文件改了，但还没有加入暂存区。

看到文件在Changes to be committed下面，说明这个文件已经add了，下一步可以commit。

这个命令很适合用来确认现场。尤其是准备提交前，先看一眼可以避免把奇怪的文件一起提交上去。

第二步：看改了什么

只知道“文件改了”还不够，最好再看看具体改了哪些内容。

git diff

git diff默认查看工作区里还没有add的改动。

如果文件已经add进暂存区了，想看这次准备提交的内容，可以用：

git diff --cached

只看某个文件：

git diff 文件名

我个人建议提交前尽量看一眼diff，尤其是写代码时临时加过console.log、测试地址、乱七八糟的注释，很容易忘记删。

第三步：选择要提交的内容

确认改动没问题后，就可以把文件加入暂存区。

提交某一个文件：

git add login.js

提交当前目录下所有改动：

git add .

git add .很方便，但也最容易把不该提交的东西带进去。比如日志文件、临时文件、编译产物、.env配置文件。

如果你同时改了两个文件：

login.js
README.md

但这次只想提交登录相关代码，就不要直接git add .，而是：

git add login.js
git commit -m "修复登录失败问题"

这样README.md的改动还留在工作区，不会被这次提交带上。

第四步：提交到本地仓库

文件加入暂存区后，就可以提交了。

git commit -m "添加登录页面"

commit保存的是暂存区里的内容，也就是你前面git add进去的那些改动。

一个提交最好只做一件事。比如修bug就修bug，改文档就改文档，别把“修复登录问题”和“顺手调整首页样式”混成一个提交。

提交说明也别总写：

git commit -m "update"

这种写法当时很爽，三天后自己看日志也不知道这个update到底更新了什么。

可以写得具体一点：

git commit -m "添加登录页面"
git commit -m "修复登录失败提示"
git commit -m "更新登录接口地址"

提交说明不一定要特别长，但至少要让人知道这次提交主要做了什么。

第五步：推送前先拉一下

提交完成后，很多人会直接：

git push

如果只有你一个人在改这个仓库，通常没问题。

但如果远程仓库里已经有人提交了新内容，你本地还不知道，直接推送可能会被拒绝。所以比较稳妥的习惯是推送前先拉一下：

git pull
git push

git pull其实做了两件事：

git pull = git fetch + git merge

fetch是把远程的新提交下载下来，merge是把远程分支合并到你当前分支。

所以pull为什么会冲突？因为它本质上做了合并。

如果远程有人改了同一段代码，你本地也改了同一段，Git当然不知道该保留谁的。

第六步：推送到远程仓库

确认本地提交没问题，也拉取过远程更新后，就可以推送：

git push

推送成功后，远程仓库页面上就能看到你的提交。

如果是第一次推送一个新分支，可能需要写完整一点：

git push -u origin 分支名

-u是设置上游分支，设置之后以后就可以直接git push。

分支协作的完整流程我会放到下一篇讲，这篇先记住一件事：push才是上传远程，commit只是提交到本地。

改错了怎么撤回

写代码时改错文件很正常，关键是先看清楚改动在哪个阶段。

如果文件还没有add，想恢复到上一次提交时的样子：

git restore 文件名

撤销当前目录下所有未暂存修改：

git restore .

这个命令会直接丢掉你的未提交修改，执行前最好先用git diff看一下。

如果文件已经git add了，但还没commit，想把它从暂存区拿出来：

git restore --staged 文件名

这只是取消暂存，文件内容还在。

简单记：

git restore --staged 文件名  = 从暂存区拿出来
git restore 文件名           = 丢掉工作区修改

哪些文件不要提交

项目里总有些东西不应该交给Git管，比如依赖目录、编译产物、日志、环境变量文件。

常见的.gitignore大概长这样：

node_modules
dist
.env
*.log

.env这种文件尤其要注意，里面经常放密钥、数据库密码之类的东西，不要随便提交。

如果文件已经被提交过，再写进.gitignore是没用的，因为Git已经认识它了。要先取消跟踪：

git rm --cached 文件名

目录的话：

git rm -r --cached 目录名

然后再提交一次。

.gitignore不是删除文件，它只是告诉Git以后别继续跟踪这些文件。

简单认识一下分支

分支听起来像是团队协作才用的东西，其实一个人写项目也很有用。

比如主分支main现在是能正常运行的版本。你突然想大改登录逻辑，如果直接在main上改，改一半发现跑不起来了，就很尴尬。

这时可以开个新分支：

git switch -c feature-login

查看当前有哪些分支：

git branch

切回主分支：

git switch main

分支的意义就是：

我可以在一条独立的线上折腾，折腾好了再合回主分支。

至于多人协作时怎么创建功能分支、怎么推送分支、怎么发Pull Request、怎么合并回main，下一篇《Git协作流程》会继续讲。

发生冲突怎么办

冲突通常出现在pull、merge、rebase这些操作时。

冲突文件里一般会出现这种东西：

<<<<<<< HEAD
这是你本地的内容
=======
这是远程分支的内容
>>>>>>> origin/main

它的意思是：同一个位置，两边都有修改，Git不知道该选哪边。

你要做的是手动改成最终想要的内容，然后把这些冲突标记删掉。

如果是普通pull或merge产生的冲突，处理完后：

git add 冲突文件
git commit

如果你用的是：

git pull --rebase

冲突处理完后继续：

git add 冲突文件
git rebase --continue

不想继续这次rebase，可以取消：

git rebase --abort

冲突本身不可怕，它只是Git不敢替你做选择。解决完以后，最好重新跑一下项目，确认代码逻辑真的没问题。

看历史用log

提交多了以后，可以用git log看历史：

git log

默认输出比较长，平时我更常用这个：

git log --oneline

输出大概是：

a1b2c3d 修复登录失败问题
e4f5g6h 添加用户设置页面

前面那串是提交ID，后面是提交说明。

如果想看分支关系，可以用：

git log --oneline --graph --all

刚开始不一定要看懂所有线条，至少能看出来提交历史是怎么往前走的。

常用命令速查

查看当前状态：

git status

查看具体改动：

git diff

查看暂存区里的改动：

git diff --cached

加入暂存区：

git add 文件名
git add .

提交到本地仓库：

git commit -m "提交说明"

拉取远程更新：

git pull

推送到远程：

git push

撤销未提交修改：

git restore 文件名

取消暂存：

git restore --staged 文件名

查看历史：

git log --oneline

创建并切换分支：

git switch -c 分支名

切换分支：

git switch 分支名

总结

这篇先不用死记很多高级命令，重点记住一条线：

工作区 -> git add -> 暂存区 -> git commit -> 本地仓库 -> git push -> 远程仓库

以及一套日常流程：

git status
git diff
git add .
git commit -m "提交说明"
git pull
git push

先用status看现场，用diff确认改动，再add、commit、pull、push。

把这套流程用顺以后，再去理解分支、合并、Pull Request，就不会觉得Git那么玄学了。

Gitea与Git配置

Wed, 20 May 2026 00:00:00 GMT

前言

Gitea是一个轻量级的Git代码托管服务，功能和Github、GitLab类似，可以用来搭建自己的私有仓库。

这篇文章主要记录本地Git连接Gitea时需要做的配置，包括用户名邮箱、SSH密钥、仓库推送和常见报错处理。

安装Git

Windows可以直接去Git官网下载Git for Windows。安装时如果不确定选项，基本保持默认即可。安装完成后，建议右键打开Git Bash执行后面的Git和SSH命令，这样Linux里的大部分命令都能直接使用。

如果习惯用PowerShell，也可以使用Git，但部分命令写法会不同，后面会单独标出来。

Linux一般用系统包管理器安装：

# Debian / Ubuntu
sudo apt install git

# Arch Linux
sudo pacman -S git

# Fedora
sudo dnf install git

安装完成后检查版本：

git --version

配置Git用户名和邮箱

这一步会影响提交记录里显示的作者信息。

git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"

查看配置：

git config --global --list

如果只想给当前仓库单独设置，不要加--global：

git config user.name "你的用户名"
git config user.email "你的邮箱"

生成SSH密钥

推荐使用SSH连接Gitea，这样以后推送代码不用每次输入账号密码。

先检查本机是否已经有SSH密钥。

Linux、macOS、Windows Git Bash：

ls ~/.ssh

Windows PowerShell：

dir $env:USERPROFILE\.ssh

如果已经有id_ed25519.pub或id_rsa.pub，可以直接使用现有公钥。没有的话生成一个新的：

ssh-keygen -t ed25519 -C "你的邮箱"

一路回车即可。Windows默认也会生成到C:\Users\你的用户名\.ssh\目录。

生成完成后查看公钥。

Linux、macOS、Windows Git Bash：

cat ~/.ssh/id_ed25519.pub

Windows PowerShell：

type $env:USERPROFILE\.ssh\id_ed25519.pub

复制输出的整行内容，注意是.pub结尾的公钥，不要把私钥复制出去。

在Gitea添加SSH公钥

登录Gitea后，进入用户设置，找到SSH/GPG密钥，将刚刚复制的公钥添加进去。添加完成后，在本地测试连接：

ssh -T git@你的Gitea域名

例如：

ssh -T git@git.example.com

第一次连接会提示是否信任主机，输入yes即可。

如果能看到类似欢迎信息，说明SSH配置成功。

配置Windows换行

Windows默认换行是CRLF，Linux默认是LF。如果项目里多人协作，建议先设置Git的换行处理。

git config --global core.autocrlf input

创建并推送新仓库

先在Gitea网页端新建一个空仓库，创建时建议先不要勾选初始化README，这样本地推送最简单。然后在本地项目目录执行：

git init
git add .
git commit -m "Initial commit"
git branch -M main
git remote add origin 你刚刚复制的SSH地址
git push -u origin main

克隆已有仓库

如果仓库已经存在，直接复制Gitea页面上的SSH地址：

git clone 你复制的SSH地址

进入目录后就可以正常拉取和推送：

cd 仓库名
git pull
git push

HTTPS方式

如果不想配置SSH，也可以使用HTTPS地址：

git clone https://你的Gitea域名/用户名/仓库名.git

但是现在很多Git服务不再推荐直接用账号密码推送，通常需要使用访问令牌。Gitea可以在用户设置里创建Access Token，然后推送时用Token代替密码。

修改远程仓库地址

查看当前远程地址：

git remote -v

如果之前用了HTTPS，想改成SSH：

git remote set-url origin git@你的Gitea域名:用户名/仓库名.git

再次检查：

git remote -v

多个Git账号配置

如果同时使用Github和自己的Gitea，建议给不同服务配置不同密钥。

先生成一个专门给Gitea用的密钥：

ssh-keygen -t ed25519 -C "你的邮箱" -f ~/.ssh/id_ed25519_gitea

然后编辑~/.ssh/config。Windows对应路径是C:\Users\你的用户名\.ssh\config，没有这个文件就新建一个。

Host gitea
    HostName 你的Gitea域名
    User git
    IdentityFile ~/.ssh/id_ed25519_gitea

之后仓库地址可以写成：

git remote set-url origin gitea:用户名/仓库名.git

测试连接：

ssh -T gitea

常见问题

Permission denied (publickey)

一般是SSH公钥没有配置好，可以按下面步骤排查：

确认Gitea里添加的是.pub公钥。
确认本地远程地址是SSH地址，不是HTTPS地址。
执行ssh -T git@你的Gitea域名测试连接。
多密钥环境下检查~/.ssh/config是否写对。

src refspec main does not match any

通常是本地还没有提交，先提交一次：

git add .
git commit -m "Initial commit"
git push -u origin main

也可能是当前分支不叫main，用下面命令查看：

git branch

failed to push some refs

远程仓库里已经有提交，而本地没有同步。先拉取：

git pull --rebase origin main

解决冲突后再推送：

git push

端口不是22怎么办

如果Gitea的SSH端口不是默认的22，比如是2222，仓库地址可以写成：

git clone ssh://git@你的Gitea域名:2222/用户名/仓库名.git

也可以写进~/.ssh/config：

Host gitea
    HostName 你的Gitea域名
    User git
    Port 2222
    IdentityFile ~/.ssh/id_ed25519_gitea

然后使用：

git clone gitea:用户名/仓库名.git

总结

日常使用Gitea主要就是三步：

本地配置Git用户名和邮箱。
生成SSH密钥并添加到Gitea。
使用SSH地址克隆或推送仓库。

配置完成后，Gitea和其他Git托管平台的使用方式基本一致，常用命令还是git clone、git pull、git add、git commit和git push。

Minecraft主题电脑

Wed, 24 Dec 2025 01:15:55 GMT

GRUB：https://github.com/Lxtharia/minegrub-theme

SDDM：https://github.com/Davi-S/sddm-theme-minesddm

Paru无法打开报错解决

Mon, 15 Dec 2025 13:51:10 GMT

paru: error while loading shared libraries: libalpm.so.15: cannot open shared object file: No such file or directory

先卸载paru,重新编译，如果遇见编译报错，用下面的buildpkg

https://github.com/Morganamilo/paru/issues/1454#issuecomment-3620788285

# Maintainer: Morgan <morganamilo@archlinux.org>
pkgname=paru
pkgver=2.1.0
pkgrel=2.1
pkgdesc='Feature packed AUR helper'
url='https://github.com/morganamilo/paru'
source=("$pkgname-$pkgver.tar.gz::https://github.com/Morganamilo/paru/archive/v$pkgver.tar.gz")
backup=("etc/paru.conf")
arch=('i686' 'pentium4' 'x86_64' 'arm' 'armv7h' 'armv6h' 'aarch64')
license=('GPL-3.0-or-later')
makedepends=('cargo')
depends=('git' 'pacman' 'libalpm.so>=14')
optdepends=('bat: colored pkgbuild printing' 'devtools: build in chroot and downloading pkgbuilds')
sha256sums=('eea4dbb524db765d5316f540f9ee670c0bf81aae4827b5417eebb4c9b5651727')

prepare() {
  cd "$pkgname-$pkgver"

  patch -Np1 <<EOF
diff --git a/Cargo.toml b/Cargo.toml
index 26063f7..eb556cf 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -75,2 +75,2 @@ mock_chroot = ["mock"]
-#alpm = { path = "../alpm.rs/alpm" }
-#alpm-utils = { path = "../alpm.rs/alpm-utils" }
+alpm = { git = "https://github.com/archlinux/alpm.rs.git", rev = "b010ec79ee92b54e87f07fa4e287cbabc035c0ca" }
+alpm-utils = { git = "https://github.com/archlinux/alpm.rs.git", rev = "b010ec79ee92b54e87f07fa4e287cbabc035c0ca" }
EOF
  rm Cargo.lock

  cargo fetch --target "$(rustc -vV | sed -n 's|host: ||p')"
}

build () {
  cd "$srcdir/$pkgname-$pkgver"

  if pacman -T pacman-git > /dev/null; then
    _features+="git,"
  fi

  if [[ $CARCH != x86_64 ]]; then
    export CARGO_PROFILE_RELEASE_LTO=off
  fi

  cargo build --frozen --features "${_features:-}" --release --target-dir target
  ./scripts/mkmo locale/
}

package() {
  cd "$srcdir/$pkgname-$pkgver"

  install -Dm755 target/release/paru "${pkgdir}/usr/bin/paru"
  install -Dm644 paru.conf "${pkgdir}/etc/paru.conf"

  install -Dm644 man/paru.8 "$pkgdir/usr/share/man/man8/paru.8"
  install -Dm644 man/paru.conf.5 "$pkgdir/usr/share/man/man5/paru.conf.5"

  install -Dm644 completions/bash "${pkgdir}/usr/share/bash-completion/completions/paru.bash"
  install -Dm644 completions/fish "${pkgdir}/usr/share/fish/vendor_completions.d/paru.fish"
  install -Dm644 completions/zsh "${pkgdir}/usr/share/zsh/site-functions/_paru"

  install -d "$pkgdir/usr/share/"
  cp -r locale "$pkgdir/usr/share/"
}

Arch Linux清理垃圾

Thu, 09 Oct 2025 14:19:32 GMT

清理 pacman 缓存

查看缓存大小

sudo du -sh /var/cache/pacman/pkg

清理旧版本（保留每个包最近两个版本）

sudo paccache -r

删除不再需要的依赖包

sudo pacman -Rns $(pacman -Qdtq)

清理 AUR 助手缓存

yay:

sudo yay -Sc

paru:

sudo paru -Sc

清理日志文件

清理 journal 日志（systemd）：

sudo journalctl --vacuum-time=7d

Windows+Linux双系统时间不统一修复

Thu, 09 Oct 2025 13:54:26 GMT

为什么会出现时间不统一

Windows 和大多数 Linux 发行版对硬件时钟（RTC）的理解不一样：

Windows 默认把主板时间当作本地时间
Linux 默认把主板时间当作 UTC 时间

所以你在一个系统里把时间校准好，重启进另一个系统后，就可能会出现快 8 小时或者慢 8 小时的问题。

方案一：修改 Windows，推荐

这个方案更推荐，因为 Linux 默认使用 UTC 更合理，也更符合服务器和多系统环境的习惯。

在 Windows 中按 Win + X，打开 Windows PowerShell（管理员） 或 终端（管理员），执行：

Reg add HKLM\SYSTEM\CurrentControlSet\Control\TimeZoneInformation /v RealTimeIsUniversal /t REG_DWORD /d 1

执行完成后，重启 Windows。

如果想立刻同步一次时间，可以再到：

设置 -> 时间和语言 -> 日期和时间
打开“自动设置时间”
点击“立即同步”

恢复默认设置

如果后面你想撤销这个修改，可以在管理员 PowerShell 中执行：

reg delete HKLM\SYSTEM\CurrentControlSet\Control\TimeZoneInformation /v RealTimeIsUniversal /f

方案二：修改 Linux，让 Linux 兼容 Windows

如果你不想改 Windows，也可以反过来让 Linux 直接把 RTC 当成本地时间。

在 Linux 终端执行：

sudo timedatectl set-local-rtc 1 --adjust-system-clock

然后检查当前状态：

timedatectl

如果输出里出现下面这一项，说明设置成功：

RTC in local TZ: yes

恢复 Linux 默认行为

如果你之后想改回 Linux 默认的 UTC 方式，可以执行：

sudo timedatectl set-local-rtc 0 --adjust-system-clock

再次查看：

timedatectl

看到下面这一项即可：

RTC in local TZ: no

两种方案怎么选

只改一次，长期稳定使用：推荐改 Windows
不方便动 Windows 注册表：就改 Linux
如果你经常折腾多系统、远程同步、时区切换：也更建议保留 Linux 的 UTC 逻辑，只改 Windows

修改后建议再做一次校时

无论你选哪种方案，改完后都建议进入当前系统手动同步一次网络时间，再重启到另一个系统检查。

Linux 下可以执行：

timedatectl set-ntp true
timedatectl status

Windows 下则在“日期和时间”设置里点一次“立即同步”即可。

Arch+Windows双系统|Btrfs文件系统

Sat, 04 Oct 2025 10:33:00 GMT

此教程仅适用于 UEFI 设备。

前提与准备

开始之前，先确认这篇教程的前提：

电脑里已经安装了 Windows
目标磁盘已预留一块未分配空间给 Arch Linux
安装方式使用 archinstall
文件系统使用 btrfs

下载Arch镜像：https://archlinux.org/download/

往下翻，在中国镜像站选一个点进去

下载iso结尾的文件

然后下载打开Rufus，https://rufus.ie/zh/

插入U盘，选择镜像，刷写镜像。

然后打开磁盘管理（Disk Management）

确保你想要安装linux的空间是无分区的

制作启动盘并进入安装环境

按住Shift，点击开始菜单中的重启按钮，然后稍等一会，进入这个页面，选择第二项。

然后选择你的U盘

随后会自动重启。

稍等片刻进入选择启动项。

BIOS：

UEFI：

选择第一个，或者等时间到自动选择。

然后便进入了archiso安装系统。

首先确保你电脑有网，可以ping一下百度。

注意：Linux 中的 ping 不会自动停止，使用 Ctrl+C 退出。

联网方式

如果 ping 不通，可以根据自己的网络环境，选择下面一种方式联网。

Wi-Fi

如果你现在还没连上 Wi-Fi，可以先用 iwctl 连接无线网络。

先进入 iwctl：

iwctl

查看无线网卡设备名：

device list

一般会看到类似 wlan0 或 wlp3s0 这样的设备名。下面用 wlan0 作为例子，你需要替换成自己的实际名称。

扫描附近 Wi-Fi：

station wlan0 scan

查看扫描结果：

station wlan0 get-networks

连接你的 Wi-Fi：

station wlan0 connect 你的WiFi名称

如果 Wi-Fi 名称里有空格，记得加引号，例如：

station wlan0 connect "My Home WiFi"

输入密码后，等待连接完成，然后输入 exit 退出 iwctl，再重新测试网络：

ping baidu.com

有线宽带拨号（PPPoE）

如果你是有线连接，但网络环境需要宽带拨号（PPPoE），可以这样连接：

先确认网线已经插好，然后运行：

pppoe-setup

这个命令会依次让你填写：

网卡名称，一般是 enp3s0、eth0 这类名字
宽带账号
宽带密码
DNS，直接选默认即可

配置完成后，启动拨号：

pppoe-start

拨号成功后，再测试网络：

ping baidu.com

如果后面需要断开拨号，可以执行：

pppoe-stop

输入archinstall进入简易的安装程序。

这个页面可能会等一会。

使用 archinstall 安装

区域设置

语言和区域先不改。

选择第三项，回车。

然后选择第一项（Select regions），回车。

找到China，空格选择，回车保存退出。

然后选择Back，回到主页面。

磁盘分区

接着配置第4项，磁盘管理。

选择你的磁盘

然后选择刚刚的未分区空间

先分出1GiB作为efi分区。

文件系统选fat32，挂载点输入/boot。

然后继续分区。

这一次不用填大小，留空即可，然后回车。

文件系统选btrfs。

然后选择刚刚创建的btrfs分区。

创建 Btrfs 子卷

选择创建子卷。

创建@home子卷

然后挂载到/home

接下来的子卷操作一样：

子卷@，挂载到/
子卷@log，挂载到/var/log

然后就可以保存了。

其他安装选项

返回到主界面，其中Bootloader选择Grub。

Hostname主机名自己修改。

Authentication中创建账号，选择第二个创建用户账户。

然后这里会提示是否作为超级用户，选择是（默认）。

在Profile中可以选择你想要的桌面环境，我这里就不选了。

在Applications中选择蓝牙和音频。

音频选择Pipewire。

返回主菜单中选择网络配置（Network configuration）。

如果你是有线连接的，选择第一个即可。

然后在TimeZone中选择Asia/Chongqing或者Asia/Shanghai。

最后选择Install，开始安装。

安装完成后进入 chroot 环境

安装完后选择第三个。

配置 GRUB 并识别 Windows

先安装grub对应的依赖：对应你 CPU 的intel-ucode 或 amd-ucode。

Intel：

pacman -S intel-ucode os-prober vim

AMD：

pacman -S amd-ucode os-prober vim

然后编辑 /etc/default/grub。

vim /etc/default/grub

找到 GRUB_DISABLE_OS_PROBER，然后按i进入编辑模式，删除这个#。

然后按ESC，退出编辑模式，输入:wq保存退出。

随后生成配置文件。

grub-mkconfig -o /boot/grub/grub.cfg

观察输出文本，看是否有 Windows 字样出现。

比如我这个就没有出现 Windows，说明没有识别到 Windows 引导。

手动挂载 Windows EFI 分区

先输入lsblk -f确认分区情况。

然后找到你 Windows 的 EFI 分区，比如我这个就是 /dev/sda1。

创建挂载点并挂载分区：

mkdir -p /mnt/win-efi
mount /dev/sda1 /mnt/win-efi

更新Grub配置：

grub-mkconfig -o /boot/grub/grub.cfg

此时 Windows 的引导就出来了。

调整 EFI 启动顺序

接着我们查看启动顺序是否正确。

efibootmgr -v

观察BootOrder后面的顺序，然后和下面对比着看，我们要确保Grub在第一个，至少要比 Windows 更前面。

如果 Windows 在 GRUB 前面，那就参考下面命令修改。下面命令别抄，对照你自己的实际情况：

efibootmgr -o XXXX,XXXY

退出并重启

exit 退出 chroot 环境。

umount -R /mnt 卸载 /mnt 下的所有硬盘。

reboot 重启设备。

随后便会进入 GRUB 引导选择。

常见问题

启动项没有 GRUB

执行 GRUB 安装：

grub-install --target=x86_64-efi --efi-directory=/boot --bootloader-id=GRUB

随后再生成配置：

grub-mkconfig -o /boot/grub/grub.cfg

再次查看：

efibootmgr -v

Packet Tracer在Arch Linux安装教程

Sat, 13 Sep 2025 07:30:21 GMT

前言

Packet Tracer 是 Cisco 推出的一个功能强大的网络模拟与可视化工具，它通过虚拟化路由器、交换机、无线设备和终端等网络组件，让用户能够在没有真实硬件的情况下，搭建、配置和调试各种网络拓扑，学习和验证如 TCP/IP、VLAN、STP、OSPF、EIGRP 等多种网络协议的工作原理，因此广泛应用于网络技术学习、CCNA/CCNP 等认证考试备考，以及课堂教学和实验环境。

首先，根据Wiki上的指南，Packet Tracer无法使用aur安装。

packettracerAUR can not be installed using automated methods (e.g. AUR helper) because the software's tarball must be downloaded first before building the package.

这里我提供一个根据官方教程构建的软件包。（amd64）

https://www.123684.com/s/QvNTjv-LEWO

注意：使用软件需要登陆思科账号。

构建指南

首先打开https://aur.archlinux.org/packages/packettracer下载构建文件

点击下载快照即可。

解压构建文件，然后在思科官网下载deb安装包，注意下载下来的文件名是Packet_Tracer822_amd64_signed.deb以便于构建

Log into Cisco Networking Academy (Skills For All / NetAcad) using your Cisco Account. Register an account if you do not have it.

Once in the Networking Academy portal, download Cisco Packet Tracer 8.2.2 or 9.0.0 open beta.

Rename the deb package to Packet_Tracer822_amd64_signed.deb so it is recognized by the build script.

将deb放在和PKGBUILD文件同级目录下

Place the .deb file inside the folder where packettracerAUR's build files are located — that is the same folder where the PKGBUILD file is found.

然后终端中进入这个目录（PKGBUILD同级），执行makepkg -s

安装

在终端中输入sudo pacman -U 【编译出来的软件名字】，如果你使用我提供的软件包，即为sudo pacman -U packettracer-8.2.2-1-x86_64.pkg.tar.zst

WSL(Windows Subsystem for Linux)安装指南

Fri, 12 Sep 2025 15:14:00 GMT

1.在线安装

win+x，选择Windows Powershell（管理员）或者是命令提示符（管理员）打开。

输入wsl --update，或者wsl --update --web-download

然后wsl --list --online，可以选择你要的版本。然后wsl --install 【你要的版本】。或者是打开Microsoft Store，然后选择你要的系统（Ubuntu之类的）。

2.离线安装

wsl下载通常因为网络问题卡住，可以选择使用这种方式。

https://github.com/microsoft/WSL/releases

打开wsl的github，下载离线包。

如果下载慢的话，可以用github镜像站下载

比如https://ghfast.top/

然后步骤和上面一样

Windows下实现多声卡聚合

Fri, 04 Apr 2025 16:40:53 GMT

软件：

https://vb-audio.com/Voicemeeter/

在左边input中选择两个不同的声卡，然后右边调节输出。实际电脑使用

记一次更新python导致的apt报错

Sat, 22 Mar 2025 08:33:47 GMT

这是执行sudo apt update 的报错

E: Problem executing scripts APT::Update::Post-Invoke-Success 'if /usr/bin/test -w /var/lib/command-not-found/ -a -e /usr/lib/cnf-update-db; then /usr/lib/cnf-update-db > /dev/null; fi'
E: Sub-process returned an error code

原因是我将python从3.12升级为了3.13。

解决办法：

sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.12 1

记录下上海Major通行证预测

Fri, 29 Nov 2024 11:51:31 GMT

VS Code编译cpp环境配置

Sat, 16 Nov 2024 11:27:48 GMT

其他的网上都能找到

我这只放三个文件

放在.vscode下

c_cpp_properties.json

{
    "configurations": [
        {
            "name": "Linux",
            "includePath": [
                "${workspaceFolder}/**"
            ],
            "defines": [],
            "compilerPath": "/usr/bin/gcc",
            "cStandard": "c11",
            "cppStandard": "gnu++11",
            "intelliSenseMode": "linux-gcc-x64",
            "compilerArgs": []
        }
    ],
    "version": 4
}

launch.json

{
    // 使用 IntelliSense 了解相关属性。 
    // 悬停以查看现有属性的描述。
    // 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "(gdb) 启动",
            "type": "cppdbg",
            "request": "launch",
            "program": "${fileDirname}/${fileBasenameNoExtension}",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${fileDirname}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "setupCommands": [
                {
                    "description": "为 gdb 启用整齐打印",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": false
                },
            ],
            "preLaunchTask": "C/C++: g++ 生成活动文件",
            "miDebuggerArgs": "-q -ex quit; wait() { fg >/dev/null; }; /bin/gdb -q --interpreter=mi",
            "miDebuggerPath": "/usr/bin/gdb"
            
        }
    ]
}

tasks.json

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: g++ 生成活动文件",
            "command": "g++",
            "args": [
                "${file}",
                "-fdiagnostics-color=always",
                "-o",
                "${fileDirname}/${fileBasenameNoExtension}",
                "-g3",
                "-pipe",
                "-Wall",
                "-D_DEBUG"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": "build",
            "detail": "编译器: /usr/bin/g++"
        },
    ]
}

以上配置文件基于linux，windows其实同理，运行就按ctrl+F5

修复了老文章照片不显示问题

Fri, 08 Nov 2024 13:03:14 GMT

记录修复博客老文章图片不显示问题的情况，以及部分图片无法恢复的说明。

节日快乐

Thu, 24 Oct 2024 01:48:06 GMT

1024,程序员节

🎆🎆🎆

emm别乱发评论

Fri, 04 Oct 2024 04:10:06 GMT

有点离谱了，好久没看blog，结果都开始发这玩意了吗？

OpenWrt通过Rclone开机自动挂载

Fri, 28 Jun 2024 07:23:52 GMT

本文默认读者已完成rclone配置。

打开启动项，选择本地启动脚本

REMOTE='aliyunpan:/aliyunpan/Media'
LOCAL='/home/aliyunpan'
LOG_FILE="/var/log/rclone-mount.log"
CONFIG='/root/.config/rclone/rclone.conf'

rclone mount $REMOTE $LOCAL --config $CONFIG --allow-other --allow-non-empty --vfs-cache-mode writes --header "Referer:https://www.aliyundrive.com/" >> $LOG_FILE 2>&1 &

修改：添加参数：--header "Referer:https://www.aliyundrive.com/"

其中REMOTE，LOCAL根据你自己情况修改。
保存设置，重启OpenWrt。
如果发现没有挂载完成，可以查看var/log/rclone-mount.log。

迁站

Mon, 08 Jan 2024 04:25:00 GMT

前段时间把服务器迁到了国内，再配上国内cdn，现在网站速度变快了许多。
首页也弄好了aloys233.top。
后面有时间把自建的工具整理起来

定位一个窗口是哪个软件产生的

Thu, 26 Oct 2023 01:43:00 GMT

在这里我就只直接讲方法，不讲原理。

方法一不用安装任何软件（推荐）

方法一不用安装任何软件即可实现定位窗口。
Win+R打开运行，输入psr.exe，回车。

点击右边【设置】，输出文件随便选个方便的地方，随便给个名字，点击【确定】。
然后点击开始记录，再随便点下那个窗口，然后打开你刚刚选的路径，打开保存的记录文件，找到记录的步骤，如下。

可以看到里面显示了弹窗这个程序的名称。
打开cmd，输入wmic process where (Description="文件名.exe"),即可看到文件目录。

方法二

安装火绒，打开安全工具-弹窗拦截

点击截图拦截
选中窗口，即可看见软件名。
打开cmd，输入wmic process where (Description="文件名.exe"),即可看到文件目录。

桌面图标间隙变大解决方案

Mon, 02 Oct 2023 14:10:00 GMT

原因分析：HDMI接了电视，多次调整分辨率导致。

打开注册表编辑器，找到

HKEY CURRENT USERI/Control Panel/Desktop/WindowMetrics

将IconSpacing修改为-1125，IconVerticalSpacing也修改为-1125。
弄好后重启电脑就好。

Ubuntu进不去桌面

Sat, 16 Sep 2023 05:05:00 GMT

前段时间，我以前用的电脑进不去桌面了，开机后黑屏，电脑为ubuntu。
如果你也遇到这种情况，请回忆下干了什么导致进不去桌面，我是因为切换独显驱动没成功，然后就重启，导致这种情况的。
开机完成后，按住Ctrl+Alt+F1(F1~F7分别是不同的模式，前6个为控制台模式)，输入用户名，密码。
注意：我这边按了以后大概过几秒就又黑屏，输密码一定要搞快。
然后直接删除显卡驱动，再更新显卡驱动，就行。

html标签br和p所换行的区别

Sat, 09 Sep 2023 11:39:24 GMT

在html中， 的作用是换行。而为正文标签，特点有独占一行。
所以 和可以达成相似的换行效果。
它两区别就是一个中间有空行，一个没有
123123

123

456 456

456
456

访问量增加了

Wed, 06 Sep 2023 06:54:10 GMT

加入travellings后，最近两个月访问量大增。
travellings是个好项目，至少让我这个新手站长创建的网站能获得更多曝光。
我的博客估计是没备案，文章数也不多，seo也没做好，百度根本不收录，只有google，bing等收录。
题外话：我感觉是不是我把统计换成了自建umami，导致数据变多了。
因为谷歌分析很多（应该是绝大部分）广告屏蔽器直接拦截了。

所以这个成就是干啥的？

Thu, 31 Aug 2023 13:40:00 GMT

四川征集志愿网站缺点分析

Sat, 22 Jul 2023 10:11:17 GMT

前言

大佬勿喷

正文

源代码：

var browser = {
                versions: function () {
                    var u = navigator.userAgent, app = navigator.appVersion;
                    return {
                        trident: u.indexOf('Trident') > -1, //IE内核                
                        presto: u.indexOf('Presto') > -1, //opera内核                
                        webKit: u.indexOf('AppleWebKit') > -1, //苹果、谷歌内核                
                        chrome: u.indexOf('Chrome') > -1, //谷歌浏览器
                        gecko: u.indexOf('Gecko') > -1 && u.indexOf('KHTML') == -1, //火狐内核                
                        mobile: !!u.match(/AppleWebKit.*Mobile.*/) || !!u.match(/AppleWebKit/), //是否为移动终端                
                        ios: !!u.match(/\(i[^;]+;( U;)? CPU.+Mac OS X/), //ios终端                
                        android: u.indexOf('Android') > -1 || u.indexOf('Linux') > -1, //android终端或者uc浏览器                
                        iPhone: u.indexOf('iPhone') > -1 || u.indexOf('Mac') > -1, //是否为iPhone或者QQHD浏览器                
                        iPad: u.indexOf('iPad') > -1, //是否iPad                
                        webApp: u.indexOf('Safari') == -1 //是否web应该程序，没有头部与底部            
                    };
                } ()
            }
            if (((browser.versions.mobile && !browser.versions.chrome) || browser.versions.ios || browser.versions.android || browser.versions.iPhone || browser.versions.iPad)) {
                alert("请勿使用手机登录志愿系统！");
                return false;
            }
            if ($(".login-from input[pass='0']").length > 0) {
                $(".login-from input[pass='0']")[0].focus();
                return false;
            }
            $("form").submit();
            return false;
        });
    });

显然他没有包含linux，也许他为了方便直接将手机当成了linux，但我为linux设备，这就很不爽
我的UA：User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36
将UA换成windows的就行
比如：Mozilla/5.0 (MSIE 10.0; Windows NT 6.1; Trident/5.0)

kindle app登录美区账号

Sat, 22 Jul 2023 09:33:00 GMT

前言

此方法也适用于在中国登录其他地区账号

方法

打开手机设置，将语言改为英语
下载安装国际版kindle
登录账号
手机设置改回中文

ChatGPT|中国大陆访问|套壳站|白嫖

Wed, 08 Mar 2023 04:21:00 GMT

一、前言

最近ChatGPT非常火，但由于某种原因，中国大陆地区无法使用它。鉴于次，许多网友利用前段时间OpenAI开放的GPT-3.5API套壳，整了些网站，以便直接使用。

二、特点

1、无需登录

2、即开即用

3、无需代理（大部分）有可能被墙

三、目前收集到的网址

https://github.com/xx025/carrot（ChatGPT集合）

https://freegpt.one（DNS污染）

https://fastgpt.app

https://chat.ninvfeng.xyz

https://chatgpt.ddiu.me

https://www.chat2ai.cn

https://chat.cydiar.com

https://chat.theb.ai

~~https://freegpt.cc~~（无|API）

https://hotoke.ai（佛祖AI）

https://chat.geekr.cool（支持语音）

四、GPT食用&调教教程：

1、中文资料&网站

《中文版的调教指南》

《一份中文ChatGPT精选资源清单》

《ChatGPT指令大全，提供了一些精炼过的提示语模板，只要输入关键词就行了》

《ChatGPT Shortcut -简单易用的ChatGPT快捷指令表，按类别整理了模板Prompts》

2、英文资料&网站

《英文版的调教指南》

《ChatGPT API，chatgpt官方提供的一些例子，是英文的》

《ChatGPT Cheat Sheet & Quick Reference，收集了一些prompt例子》

五、注意⚠️

所有套壳网站随时可能崩溃，或API受限，如遇到加载缓慢或无法加载，请切换网站。

六、引用

https://www.v2ex.com/t/921458

https://www.v2ex.com/t/921379

https://www.v2ex.com/t/921724

https://www.v2ex.com/t/921435

https://www.v2ex.com/t/920489

https://www.v2ex.com/t/920686

有部分网站没找到出处。

铜梁——安居古城

Thu, 02 Feb 2023 04:19:00 GMT

安居古城，是铜梁区同时拥有中国历史文化名镇、国家发展改革试点城镇和重庆市（省）级中心镇3张名片的特色古镇。既有别具特色错落有致的古镇建筑（传统街区），又有遍布古镇精湛的历史遗迹（九宫十八庙，历代名人手迹）；既有风光绮丽的山水美景（特色生态农业），又有独具韵味的传统风情（龙舟竞渡，民间彩扎，名特小吃）。

安居古城地处长江上游地区，在重庆铜梁区城西北部17公里处，距重庆主城九区66公里，曾于隋、唐、明朝时期建县，是一座集独特区位优势、悠久文化底蕴、丰富文物古迹、优美自然风光于一体的千年古城。

免费好用听歌软件——洛雪音乐助手|lx-music

Wed, 18 Jan 2023 11:46:00 GMT

前言

最近逛github又又又发现了新大陆。。

一个基于Electron + Vue开发的音乐软件，洛雪音乐助手。

项目地址：https://github.com/lyswhut/lx-music-desktop

https://github.com/lyswhut/lx-music-mobile

官方网站：https://lxmusic.toside.cn

优点

免费且无广告

此项目开发的初衷仅是为了对新技术的学习与研究，因此软件直至停止维护都将会一直保持纯净

多端支持

本项目支持在Windows、Mac OS、Linux、Android平台上运行。注：不计划支持IOS

开源

本项目开源发布于 GitHub 面向全世界人用作对技术的学习交流使用

下载地址：

https://github.com/lyswhut/lx-music-desktop/releases

实测

利用Github和Cloudflare搭建免费图床|CDN

Sat, 01 Oct 2022 11:37:00 GMT

前言

受到国内网络环境的影响，我使用的图床jsdelivr、sm.ms先后出现问题，便打算自建个图床，但又不想花钱，于是便有了这篇教程。

教程

1、在Github新建一个仓库

2、准备个域名，托管到Cloudflare

3、配置dns

类型选择CNAME，目标格式：[你的用户名.github.io]

注意：需要将代理状态改为已代理

4、配置Github Page

5、配置自定义域名

6、成功

7、速度测试

8、后记

因为着本质上就是静态网页，所以还可以加速其他文件。

没试过大文件传输，不确定会不会被认为滥用。

可以使用https://github.com/243286065/PictureGithubTool方便上传图片

HSTS的必要性及如何加入HSTS Preload List

Sun, 14 Aug 2022 10:53:00 GMT

HSTS是什么

HTTP严格传输安全（英语：HTTP Strict Transport Security，缩写：HSTS）是一套由互联网工程任务组发布的互联网安全策略机制。网站可以选择使用HSTS策略，来让浏览器强制使用HTTPS与网站进行通信，以减少会话劫持风险。

HSTS的作用是强制客户端（如浏览器）使用HTTPS与服务器创建连接。服务器开启HSTS的方法是，当客户端通过HTTPS发出请求时，在服务器返回的超文本传输协议（HTTP）响应头中包含Strict-Transport-Security字段。非加密传输时设置的HSTS字段无效。

作用

HSTS可以用来抵御SSL剥离攻击，因为只要浏览器曾经与服务器创建过一次安全连接，之后浏览器会强制使用HTTPS，即使链接被换成了HTTP。

另外，如果中间人使用自己的自签名证书来进行攻击，浏览器会给出警告，但是许多用户会忽略警告。HSTS解决了这一问题，一旦服务器发送了HSTS字段，将不再允许用户忽略警告。

提交要求

提供有效的证书。
如果您正在侦听端口 80，则在同一主机上从 HTTP重定向到 HTTPS。
通过 HTTPS 为所有子域提供服务。
- 特别是www，如果该子域的 DNS 记录存在，您必须支持该子域的 HTTPS 。
在基域上为 HTTPS 请求提供HSTS 标头：
- max-age必须至少为31536000秒（1 年）。
- includeSubDomains必须指定指令。
- preload必须指定指令。
- 如果您从 HTTPS 站点提供额外的重定向，则该重定向必须仍然具有 HSTS 标头（而不是它重定向到的页面）。
以下是有效 HSTS 标头的示例：

Strict-Transport-Security:max-age=63072000; includeSubDomains; preload

持续要求

您必须确保您的网站始终满足提交要求。请注意，preload从您的标头中删除该指令将使您的网站立即符合删除表格的条件，并且该网站将来可能会因未能满足要求而被自动删除。

特别是，上述要求适用于2017 年 10 月 11 日hstspreload.org或之后提交的所有域（即在 Chrome 63 之后预加载）

相同的要求适用于2016 年 2 月 29 日 或之后提交的早期域（即在 Chrome 50 之后预加载），但这些域所需的 max-age 仅为10886400几秒。

Bing壁纸接口|壁纸api

Tue, 31 May 2022 01:43:29 GMT

缙哥哥博客

https://api.dujin.org/bing/1366.php

https://api.dujin.org/bing/1920.php

杨尚臻

https://www.yangshangzhen.com/bing/wallpaper

热铁盒

https://www.retiehe.com/backend/bing/1080p

菜谱推荐-程序员做饭指南

Mon, 23 May 2022 02:00:58 GMT

最近在github上发现了个菜谱，非常适合我这样的人..

条例清晰，不会出现模糊词语。

每个人都可以提交自己的看法，相互讨论学习。

github项目地址：https://github.com/Anduin2017/HowToCook

官方网站：https://cook.aiurs.co/

Ubuntu关于软件常用命令

Thu, 19 May 2022 02:05:11 GMT

获取已安装软件包的列表(不含snap)

sudo apt list --installed

获取安装的snap包列表

snap list

安装软件(在线)

sudo apt install 「包名」
sudo apt-get install 「包名」

安装软件(软件包,deb)

sudo dpkg -i 软件

安装软件(snap)

sudo snap install 软件

卸载软件

sudo apt remove 「包名」

卸载软件(软件包,deb)

sudo dpkg -r 软件

关于电脑的常见误区

Wed, 28 Apr 2021 03:57:50 GMT

疯狂刷新

相信很多人跟我以前一样，一进入Windows桌面，就开始疯狂的刷新。否则不过瘾。其实很多从Dos，Win3.2走过来的人都知道，最早的 Windows打开一个资源管理器窗口，显示的内容就是打开的一刹那，该目录中有的文件。假设你现在用记事本在该目录保存一个txt，在资源管理器中是看不到的，必须手动刷新。这也就是「刷新」功能的由来。之所以XP以及Vista、 Win7可以看到，只是因为他们是定时自动刷新而已。只不过疯狂刷新这个小动作被很多电脑新手学会了，认为是高手必备动作。

Linux的Gnome和 KDE以及MacOS都不用刷新，也无法刷新，无论开了什么类似资源管理器的工具浏览本地目录，无论用什么软件在该目录创建或者删除了文件，就会实时显示出来，而无需刷新。也许喷子会说：实时刷新，更浪费系统资源。其实错了，这不是实时刷新，而是文件系统回调了资源管理器(类似的工具，如Mac的 Finder)的回调函数，这在软件开发行业称之为「观察者模式」，我想学过设计模式的Coder都懂吧?先进就是先进，没什么可争论的。

重装系统对电脑损耗极大

重装系统的损耗和玩游戏等操作相比，更多的损耗在于对硬盘的重新擦写。但是，对于整个磁盘寿命来讲，并不必太过担心。而且，重装系统需要备份重要数据、重新安装软件、重新对系统进行个性化设置，简直太麻烦，没有几个人愿意频繁重装吧。

文件碎片应及时清理

搭配机械硬盘的电脑需要定时进行碎片整理，不然会越用越卡。但是，和机械硬盘不同，固态硬盘内数据的物理地址是在不停变化的，进行碎片整理会导致无谓的擦写，从而损耗闪存的寿命。因此，对于固态+机械硬盘搭配使用的机台，建议系统、缓存和数据文件存放在固态硬盘上，电影、音乐等文档存放在机械硬盘上。

经常关机对电脑不好

正常关机的情况下不存在这样的说法，不过刚关机后建议过一会会再开机（或者您直接用重启功能好不好）。至于长按电源键强制关机，应当尽量避免。当然，蓝屏、死机状态下的强制关机（我想说都死机了还在乎什么强不强制呢…），一是迫于无奈，二是此时电脑也不在工作状态了，影响并不大。

苹果电脑不会中毒

其实只要是操作系统都有中毒的可能，不管是windows还是macOS或者Linux。之所以我们很少见到macOS中毒，一者是因为用户基数少，二者苹果软件安装认证严格，针对macOS病毒较少。

WP解决国内进入后台慢的最有效方法—WP-China-Yes插件

Tue, 20 Apr 2021 08:16:35 GMT

插件由来

之所以要做这一块的工作是因为wordpress.org网络慢、参与门槛高、机制不适宜国内大环境以及社区中充斥着台独、美左份子对大陆华人的排斥。

截至2020年8月12日，简体中文用户只占全部WordPress用户的2.1%，不能指望得到wordpress.org足够的重视，就好像之前一个429问题就持续了半年之久一样。

正是基于上述这些原因，所以我希望能建立一个由中国人主导的社区生态，采用一些激进的以及贴近国情的措施来刺激生态繁荣，例如：引入AI负担主要的翻译工作；应用市场允许上架闭源、付费应用等等众多改革措施。

我承认这个想法是有些疯狂的，推进过程中会面临来自诸多方面的诸多困难，无论是技术还是宣传还是方案制定还是社区组织都存在很多困难。

不过，好在我是个纯粹的理想主义者，我并不指望这个项目能盈利，更多的是期待着通过这样一个项目进行学习与积累。或者说，其实我是把这当作一个好玩儿的模拟经营类游戏来推进的。

目前的成果

1、对官方应用市场、Gravatar头像、谷歌字体等资源进行了国内的反代加速

2、本土翻译平台（https://translate.wp-china.org）已上线，该平台对标WordPress官方翻译平台（https://translate.wordpress.org），配合WP-China-Yes插件，可以提供与官方翻译平台一致的自动化体验，主要改进在于首次采用AI作为首要翻译手段，之所以能这样干是因为我基于Google翻译开发了针对中文i18n翻译的预处理及后期处理算法，最终的翻译效果应该说是吊打PoEdit Pro软件带的机翻——无需人工二次处理即符合i18n规范，可以被WordPress直接读取。

目前主要的困难是对于词汇、短语这些因为没有上下文语境，经常会被翻译错误，这些需要人工参与校准。也欢迎你参与到翻译校准的工作^_^

另外受限于服务器资源，我暂时无法实现对整个官方仓库进行监听与翻译，目前只是国内有人使用的包才会被本土翻译平台所监听，对于新安装的包则不超过24小时就会被监听到。

3、除了对官方应用市场反代外，我还开发了一个本土版本的应用市场，该应用市场目前与官方的主要区别就是与本土翻译平台进行了整合，可以无缝为大家推送来自本土翻译平台的翻译包。

下载

自2020年4月15日起，已无法通过官方应用市场安装WP-China-Yes插件，详情见：公告

下载链接：https://a1.wp-china-yes.net/apps/wp-china-yes.zip

官方网址：https://wp-china.org/

项目地址：https://github.com/sunxiyuan/wp-china-yes

IObit Advanced SystemCare 14 Pro 14.3.0.240专业便携版

Tue, 13 Apr 2021 08:12:15 GMT

软件简介：

IObit Advanced SystemCare是一款系统清理维护与安全防护软件，大幅提升整体系统性能和安全！一键AI智能模式，全面扫描优化修复系统，拥有性能加速模式、系统优化、网络加速、启动项优化、软件更新、实时监视清理、隐私安全保护等功能，可以防病毒及间谍软件，浏览器跟踪保护隐私，保护电脑免受病毒攻击。

Advanced SystemCare 除了提供一键维护和加速优化功能，还集成了一个万能【工具箱】。包括安全修复、系统优化和系统清理三个分类，与 IObit 自家其他产品组合超过20多款小工具。更难得的是，这些小工具都可以免费使用。
如：IObit Uninstaller、系统修复、启动项管理、注册表清理、Driver Booster、PCtransfer、内存整理、磁盘清理、Smart Defrag、磁盘医生、网络加速、大文件查看器、文件恢复、自动关机、空文件夹扫描、文件粉碎、程序优化、快捷方式修复：
1）系统修复。Windows 常见的系统错误，往往是由于错误的操作或配置造成的，手动修复需要耗费很长的时间去检查。而 Advanced SystemCare 系统修复工具则能扫描检测、修复这些问题。
2）网络加速。通过 TPC 优化和调整浏览器内部参数，使浏览器在更适合您网络状况的条件下，获得更快的网页浏览速度和响应速度。
3）重复文件查找。查找电脑内名字相同或内容相同的文件，提供三种比较算法：文件名称&文件大小、MD5、Byte-to-Byte。选择第一种查找速度会比较快，而选择后两种算法有更精确的扫描结果。如果您在电脑内经常有一个文件的多个副本，那么重复文件查找就可以帮您一键找出电脑内的那些文件副本，绝对是整理文件、清理硬盘空间的一大利器。

提示：「工具箱」需要梯子才能下载。

更新说明：

v 14

1、对许多功能和界面的改进完善，操作更直观方便

Dolby atmos for gaming分享

Tue, 30 Mar 2021 07:56:46 GMT

介绍：

Dolby atmos for gaming是杜比公司针对电脑玩游戏出的一个版本，对游戏内容可以有比较多的调整，适合电脑玩游戏比较多的人。主要是可以白嫖。

对射击游戏专门提供声音雷达。

下载：

链接：蓝奏云。密码：5cqn。

Picgo手动离线安装插件

Tue, 02 Mar 2021 08:31:23 GMT

将github上插件项目拉取到本地
进入在picgo日志所在目录，
输入 npm run install picgo-plugin-xxx xxx是你要安装的插件名，然后重启picgo。
这里安装包的名称还可以用项目所在的文件夹绝对路径

STEAM

Tue, 23 Feb 2021 11:34:49 GMT

STEAM代表科学（Science），技术（Technology），工程（Engineering），艺术（Arts），数学（Mathematics）。