Windows编译教程

甜甜大约 7 分钟使用指南AList魔改教程自己编译编译AList教程BuildWindows

有的小伙伴想着自己编译一下 Alist
不管是出于自己想折腾还是自己想改改源码哩.大家都可以编译~ (๑•́₃ •)

Windows版本编译教程

1.编译前准备

1.1 编译视频版教程

1.2 编译之前的前提条件

大家可以看一下这里需要啥：https://github.com/alist-org/alist/blob/main/CONTRIBUTING.mdopen in new window

编译AList Go竟然需要 1.20+了...呜呜呜

我没记错前几个月才升级了1.18+...升级真快(´◔‸◔')”

提示

这样的编译的似乎只有一个版本，如果你想要像AList官方那样编译很多可以使用 GitHub Actions 来进行编译

如果你只有修改前端的想法，强烈推荐 单独只进行编译前端即可，后端(二进制)应用程序继续使用AList官方原版的文件
- 因为现在支持引用第三方前端文件使用：参考 https://alist.nn.ci/zh/config/configuration.html#bleve-diropen in new window
这样就不用担心设备不同不会交叉编译，以及编译过程中出现的问题无法解决

编译之前我们需要先准备安装好以下软件:

以上安装过程我就不赘述了...（安装问题都解决不了的话编译也够呛）

以上软件安装好后我们先把 Go的代理改为国内 的..

安装好Golang后并且也将 "环境变量" 配置好，然后win+R 输入CMD打开DDos黑窗口(这里是用的Windows)

根据自己的配置输入：

go env -w GOPROXY=https://goproxy.cn,direct      // Windows
export GOPROXY=https://goproxy.cn,direct         // macOS 或 Linux

将代理改为国内,不然编译时会出错,前人血泪史之一... （踩坑一号）

然后我们改好后看看生效没有：

CMD黑窗口输入go env查看（需要配置好环境变量哦先）

安装好默认的是：
set GOPROXY="https://proxy.golang.org,direct"
修改代理后是
set GOPROXY=https://goproxy.cn,direct

反正不管他默认的是啥，改就完事了！！！

以上就是编译前需要的准备安装好5个软件，改一下代理 ..不难吧(ฅ'ω'ฅ)

1.3 编译前端前准备

编译前我们看看文档怎么编译：https://github.com/alist-org/alist/blob/main/CONTRIBUTING.mdopen in new window

我们需要编译前肯定是要先克隆一下前端和后端的代码（clone）

执行图上的两行命令在我们安装的 git 终端里面

你克隆到任意地方都行建议放到一个文件夹里面去,这样我们修改的时候也方便

alist.git是后端，alist-web.git是前端
无代理
git clone https://github.com/alist-org/alist.git
git clone --recurse-submodules https://github.com/alist-org/alist-web.git

代理 - （大白提供-可能服务中断了）
git clone https://hub.cooluc.com/alist-org/alist.git
git clone --recurse-submodules https://hub.cooluc.com/alist-org/alist-web.git

前后端拉取/克隆(clone)好了

但是我们拉取/克隆(clone)下来的前端里面只有一个默认的英文语言文件

我们还需要去下载一个带中文的语言文件

1.4 手动下载语言包地址

https://crowdin.com/project/alist/zh-CNopen in new window

这里是手动下载，还有命令自动下的哪个我没研究明白...害,卡了好几天了这个语言文件..

1.5 直接下载语言包直链：

https://crowdin.com/backend/download/project/alist/zh-CN.zipopen in new window

上面的语言文件放进去后我们去终端里面输入命令：

node ./scripts/i18n.mjs

执行完毕语言里面会出现一个 entry.ts 的文件，这样我们就可以用了

以上软件安装并且配置好环境变量了，Go 代理设置好了，语言包文件下载好了，我们编译前准备工作就可以了

2.编译前端

首先CD进入 alist-web 前端文件夹内，

然后输入 pnpm install 将 node_modules （包管理工具下载安装的包的文件夹），下载下来，

别问问什么不用 npm 要用 pnpm ...问就是用 pnpm 就完了...这个也是血的教训.. %>_<% ^{（踩坑2号）}

中间自己改源码的过程就不演示了，自己想怎么改就怎怎么改

改完了执行如下命令将前端文件进行编译： pnpm build npm run build 这两个二选一都行

编译好后，会看到一个叫 dist 的文件夹，这个就是我们编译好的内容一会我们移动到后端里面去

2.1 编译前端期间可能会遇到的问题

输入`pnpm install`会报错 ^(三号坑)

如果你输入 pnpm install 出现如下图中的错误

上述报错中的解决方案

如果没出现上述的错误能正常编译忽略即可！

输入 pnpm install 会报错 (四号坑)

如果你输入 pnpm install 出现如下图中的错误

上述问题的问题所在以及解决方案

问题所在

看看你前端的 solid-router 这个文件夹里面是不是空的..估计是空的
下载前端的时候没有带 --recurse-submodules 参数导致附属的文件没有下载下来

解决方案

下载前端带上 --recurse-submodules 参数去下载

git clone --recurse-submodules https://github.com/alist-org/alist-web.git

3.编译后端

在前端编译好后我们就会看到一个 "dist" 的文件夹
我们移动一下把 "dist" 目录移动到的后端的 "public" 目录里面去即可
虽然里面已经有了一个 "dist" 文件夹，不用管直接覆盖

将编译好的前端移文件动到后端里面去，准备编译

"dist" 目录移动到 "public" 去之后，我们就可以编译了（如果有改代码的需求自己改完再编译）

appName="alist"
builtAt="$(date +'%F %T %z')"
goVersion=$(go version | sed 's/go version //')
gitAuthor=$(git show -s --format='format:%aN <%ae>' HEAD)
gitCommit=$(git log --pretty=format:"%h" -1)
version=$(git describe --long --tags --dirty --always)
webVersion=$(wget -qO- -t1 -T2 "https://api.github.com/repos/alist-org/alist-web/releases/latest" | grep "tag_name" | head -n 1 | awk -F ":" '{print $2}' | sed 's/\"//g;s/,//g;s/ //g')
ldflags="\
-w -s \
-X 'github.com/alist-org/alist/v3/internal/conf.BuiltAt=$builtAt' \
-X 'github.com/alist-org/alist/v3/internal/conf.GoVersion=$goVersion' \
-X 'github.com/alist-org/alist/v3/internal/conf.GitAuthor=$gitAuthor' \
-X 'github.com/alist-org/alist/v3/internal/conf.GitCommit=$gitCommit' \
-X 'github.com/alist-org/alist/v3/internal/conf.Version=$version' \
-X 'github.com/alist-org/alist/v3/internal/conf.WebVersion=$webVersion' \
"
go build -ldflags="$ldflags" .