NotionNext升级操作指南

项目更新

本项目在长期维护更新中，不时将修复一些bug和增加新特性。新版本中对页面样式以及加载速度都做了大量的优化，因此非常推荐更新到最新版本。

访问以下文章查看版本日志：

NotionNext 更新日志 | TANGLY’s BLOG

记录NotionNext各个版本更新的功能

https://tangly1024.com/article/notion-next-changelogs

最简单的更新

当您的代码版本落后于NotionNext最新版时，则右上角将会出现一个 Fetch upstream 按钮，点击并选择 Fetch and merge即可更新为最新的代码，或者如果出现 UpdateBranch 选项也可以直接更新。

出现冲突的解决

当我和你的代码发生冲突（confilcts），(例如我修改了blog.config.js文件，你也修改了此文件)，导致在更新时，Git需要人工确认要合并代码时需要保留的最终代码版本。

此时弹出框中会显示，Discard xx commits 选项；请谨慎点击，这么做意味着您放弃了自己修改的代码，选择与我的仓库代码保持完全一致。建议先做好备份。

示例，我点击 Discard 21 commits，表示放弃自己的修改，再点击Update branch后，页面上方出现一个蓝色的提示横幅，告诉我已经成功更新。

💡

如果您此处的按钮既不是 Fetch and merge，也没有 Update branch，则说明我的代码和您的有冲突，请参考文章后面的部分进行操作。

冲突时如何更新

简单方案1

若你并不是熟悉Git的操作，推荐做法是备份一下您的代码，诸如blog.config.js配置文件，然后重新fork一遍项目，再更新新版本中的配置项，重新配置即可。

网友分享的更新方案：

047 一种更新NotionNext版本的简单方法 | Dongdong’s Blog

这是一种简答的更新notionNext版本的方法

https://ddw2019.com/047

047 一种更新NotionNext版本的简单方法 | Dongdong’s Blog

Git实践应用 | Anjhon's Blog

将本地文件夹初始化为给本地git仓库，在github上新建仓库，将本地的仓库推送到远程仓库如果想要将本地文件夹同步到已经存在且有数据的远程仓库中，建议先将本地文件上传到github，再使用vscode进行克隆，然后修改，然后推送 3、授权完成再点击克隆存储库，会出现弹窗，可以选择需要克隆的仓库 1、在对本地仓库进行更改之后会查看到提示，第一步需要将本地更改提交到暂存区 2、将暂存区的更改提交到本地版本库（master） 1、Failed to connect to github.com port 443:connection timed out 2、Git: fatal: unable to access ' https://github.com/.git/ ': LibreSSL SSL_read: error:02FFF03C:system library:func(4095):Operation timed out, errno 60 网络问题，连不上github，当前网络限制访问github导致的报错原因； 3、Git: fatal: unable to access ' https://github.com/anjhon1994/My_tools.git/ ': Failed to connect to port 443 after 75062 ms: Operation timed out git使用的网络端口不是VPN的端口，将git端口设置为vpn端口 1、先使用GitHubDesktop克隆fork后的仓库到本地 2、选择原仓库的想要更新的版本，合并到自fork后的仓库 3、如果是整个文件都被修改了（文件名相同但内容不同，如相同名称的图片）会询问是使用哪个分支的提交； 4、如果是代码文件的内容有冲突，则会提示在你的默认编辑器中进行手动合并；

https://www.anjhon.top/article/d13232f8-ea60-4a69-87dd-81ef5e9da34e

手动 NotionNext 版本更新教程 | D_SUPER BLOG

勤劳的 tangly1024 [ Github][ Blog] 大大又更新了 NotionNext 内容。之前的更新内容不涉及 blog.config.js 文件（配置博客唯一要更改的文件），可以直接 Fetch upstream → Fetch and merge 跟进版本。但是这次涉及到 blog.config.js 文件的修改，新旧内容冲突导致 Github 懵了，需要手动更新。数日前就看到需要更新，今天才得以抽空完成这一"大工程"（实在是懒）。 (1) 浏览器 [Github 已经 Fork 过 NotionNext 项目]; (2) Github desktop 客户端 [ 安装地址]; (3) Visual Studio Code - VS Code [ 安装地址].

https://www.dsuper.xyz/article/notionnext_update_221228

优化建议

建立一个专用部署分支

您可以选择在Git仓库中，建立属于自己的分支，例如我建了一个 deploy/tangly1024.com 分支，并在vercel中导入并选择使用该分支进行部署，main分支则用于提交更新最新的代码版本。

这样，以后您只需在自己的分支修改代码，然后每次更新NotionNext版本只是main分支的更新，然后在自己的仓库中选择将main合并到自己建立的部署分支即可。

部署更新失败如何解决

❓

更新后打开网页，版本号还是旧的？

请检查Vercel部署日志，查看日志方法。

Deployment模块

打开Vercel后台的Deployment标签，这里可以查看您的所有部署记录。

其中，部署状态是绿色的Ready表示成功，标注为红色的Error则失败

查看错误日志

点击此次部署记录的标题，打开详情页面

详情页下方，是打包编译的日志，在Error分组中展现了出现错误的原因，以及对应的代码行数。按照提示修正github中的代码即可重新部署。

💡

如果这个部分看不懂，可以截图向群友求助。

其他部署方式更新 (废弃)

除了Github fork部署，还支持Docker部署、Vercel一键Clone部署。这两种部署方式更新方法如下：