where 命令的介绍

在 Windows 命令提示符（CMD）中，where 命令用于查找与指定名称匹配的可执行文件的位置，它可以帮助你确定某个程序或文件在系统中的具体路径。我的使用场景是用它来查找 code 命令对应的可执行文件的路径。

现象

在 CMD 中执行 where code 命令，结果符合预期，结果如下：

但在我常用的 PowerShell 中执行的结果则是没有任何输出：

原因

这是因为在 PowerShell 中 where 表示的不再是 where.exe，而是 Where-Object cmdlet 的别名。而 Where-Object 的作用是根据属性值从集合中选择对象，和 Linux 中的 grep 命令作用类似，通常是结合管道一起使用的。现在直接执行 where code 命令，因为管道的上游没有任何输入，自然也不会输出任何内容。

在 PowerShell 中使用 where 命令的正确姿势应该是使用 where.exe ：

或者直接在 PowerShell 中使用 Get-Command 命令：

但显然 Get-Command 命令的输出显示方式远不如 where 命令直观。

参考链接

where

Where-Object

Get-Command

Why doesn’t the ‘where’ command display any output when running in PowerShell?

背景

最近动了换新笔记本和显示器的念头，自己想换一台 4K 显示器，在了解相关知识的时候，经常看到要注意视频输出接口带宽的提醒。其中各种概念多且杂，初接触很容易懵圈，所以我整理汇总了一些网上的资料，以作此文。

文中如有不对或不妥的地方，欢迎评论留言指出错误，不甚感激。

4K@60Hz 显示需要多少带宽

我们这里以一块 4K、8 bit、60 Hz 的屏幕举例，这块显示屏有 3840 * 2160 个像素点，每个像素点又由红绿蓝三个子像素构成 ，每个子像素需要 8 bit 的数据，刷新率为 60 Hz，也就是每秒需要刷新 60 次，那么每秒需要传输的数据量就是 3840 * 2160 * 3 * 8 * 60 = 11.94 Gbit，需要的带宽就是 11.94 Gbps。

上述这些数据只是我们能够在显示屏上看到的内容，实际上在传输相关画面数据的时候，还需要考虑到防止画面撕裂，以及画面对齐等等需求，需要传输比实际显示画面更多的数据，所以实际传输的数据会比上面计算的更多。

下面这张来自 B 站 Up 主硬件茶谈的表格详细列出了市面上常见分辨率及刷新率的组合分别所需要的带宽，其中还有各种显示器接口的相容性：

显示器带宽具体的计算原理可以查看 Up 主的视频-【硬件科普】4K144Hz需要传输多少数据，教你如何正确的计算显示器的带宽需求？，原理及计算方法都讲得非常清楚，动画特效也是一流。

在此也强烈安利下 Up 主，最早是在知乎关注他的，在知乎笔记本话题下相当活跃，后期转型成 B 站 Up 主，视频质量极高，讲解概念深入浅出，动画精致流畅，看他的视频可谓一种享受。我从 Up 主的视频里学到了很多硬件相关基础知识。而且 Up 主现在还只是一名在校大学生，让人不服不行，在此就祝愿 Up 主早日发大财吧。

什么是全功能 Type-C

同时具有数据传输、充电、显示三项功能的 Type-C 就称之为全功能 Type-C。而之所有会有「全功能」和「非全功能」的区分，是因为 Type-C 只是个接口形状。Type-C 接口是能够支持 100W PD 供电、DP 显示输出、USB 数据传输等功能没错，但 Type-C 接口的功能都是可以被增减的，所以并不是所有 Type-C 接口都同时具备数据传输、充电、显示三项功能。下图引用自【从入门到放弃】关于Type-C/雷电3接口的两万字科普（上篇） - 知乎 ：

每台电脑上面所配备的 Type-C 接口所具备的功能是不尽相同的，厂商基于成本或是其他方面的考虑，配备的 Type-C 可能只支持 USB 数据传输功能 ，不能充电、显示，也可能配备只支持 DP 显示和数据传输的 Type-C 口，不能充电。下图引用自【从入门到放弃】关于Type-C/雷电3接口的两万字科普（上篇） - 知乎 ：

Type-C 的「数据传输」带宽

Type-C 接口还有一个重要的参数就是 USB 版本，USB 版本越高，带宽也就越高，理论上带宽越高，传输速度越快。不过 USB 版本的命名经过了几次大的修改，命名规范变来变去，对普通消费者识别起来极不友好。下面两张图分别引用自USB type C at a glance: What the port can do, what it can’t do and why it has nothing to do with USB 3.0及维基百科-USB。其中 USB3.2 Gen 2x2 的 Logo 以维基百科的为准。

通过这两张图，我们能够比较清楚地知道各个 USB 版本对应的传输速率及兼容接口。目前笔记本上 Type-C 接口的主流速率还是 USB3.2 Gen 1 也就是 5Gbps，理论速度约合 500 MB/s。

但需要注意的是，多数情况下，「USB 几点几」这样的称呼，仅仅只是用于描述接口的「数据传输」速度，不代表这个接口其他任何能力，如能否PD充电、能否显示。

5Gbps 的 Type-C 无法满足 4K@60Hz 输出？

这个问题也是我在没了解相关知识之前相当困惑的一个地方——当我看到心仪的笔记本只有 USB 3.2 Gen1 接口和 HDMI1.4b 的接口，而两者的带宽都远小于 4K@60Hz 所需的 12.54 Gbps 时，我当时同样以为外接 4K@60Hz 显示器是不可能实现的了。

这里面的问题就在于我们混淆了 Type-C 接口的「数据带宽」和「显示带宽」，我们日常习惯说一个 Type-C 的带宽是 3.1 Gen1 或者 Gen2、5Gbps 或者10Gbps，这时候说的其实都是这个接口的 USB 数据带宽，只能代表这个接口接 U盘/移动硬盘之类的存储进行数据传输时所能达到的最大速度。

Type-C能够整合显示输出功能，主要是借助了DP Alt Mode（替代模式）功能，借助Type-C正反面诸多针脚中的几个定义为显示接口。通俗点说可以理解为单独做了个 DP 显示总线放在 Type-C 口上，所以数据带宽是 5Gbps 还是10Gbps 并不代表显示带宽也只有这么多。以目前 Type-C 的规范来看，当我们说一个 Type-C 支持显示输出时，那么这个接口至少可以支持 DP1.2 标准，也就是说拥有独立的约 21Gbps 的显示带宽，因为 DP1.2 中有 20% 的编码是用于校验的，所以真正能用来传输视频信号的带宽只有 21.60 * 0.8 = 17.28 Gbps，但这也已经完全可以满足 4K@60Hz 的传输要求了。下图引用自【拯救者科普】笔记本外接显示器需要注意什么？ - 知乎：

我们现在关于 5Gbps 的 Type-C 能否满足 4K@60Hz 画面传输的问题有了明确的答案，只要是支持显示输出的 Type-C 口，就可以支持输出 4K@60Hz。

5Gbps 的 Type-C 的不足之处

Type-C 显示输出虽然是 DP/HDMI 显示，但实际上还是借用了数据传输的一部分引脚。当一个支持 DP 显示输出的 Type-C ，而它的数据带宽是 USB3.1 Gen1 5Gbps 时，那么此时是无法通过一根线同时实现理应互不干扰的 4K@60Hz 和 USB3.0 传输的，下图引用自【从入门到放弃】关于Type-C/雷电3接口的两万字科普（上篇） - 知乎 ：

因此在一些显示器的详情界面会注明——当显示器上的 USB 设置为 3.2Gen1 时，只能输出 4K@30Hz 的画面，如果想要输出 4K@60Hz 需要将 USB 设置为 2.0 或关闭。所以如果我们使用的显示器有拓展 USB 口，而我们是使用 Type-C 直连显示器，为了保证使用体验，我们需要手动将显示器上的 USB 设置为 USB2.0，此时显示器上的 USB 更适合用来接键鼠，文件传输之类的还是直连笔记本会比较快。

参考链接

【从入门到放弃】关于Type-C/雷电3接口的两万字科普（上篇） - 知乎

【从入门到放弃】关于Type-C/雷电3接口的两万字科普（下篇） - 知乎

【拯救者科普】笔记本外接显示器需要注意什么？ - 知乎

USB type C at a glance: What the port can do, what it can’t do and why it has nothing to do with USB 3.0

维基百科-USB

视频-【硬件科普】4K144Hz需要传输多少数据，教你如何正确的计算显示器的带宽需求？

DP vs HDMI 谁才是游戏玩家最佳选择

背景

双十一的时候自己组装了一台主机，在安装操作系统的时候直接安装的 Windows 10 专业版。之前自己的笔记本是从 Windows 8.1 升级成 Windows 10，自动就激活并绑定了数字许可证，但自己组装的主机就需要考虑操作系统购买的问题了。

在不激活的情况下用了一段时间，除了不能换壁纸等个性化操作以及右下角时不时显示一个未激活水印，好像也没有多大的限制。

之前我从网上简单了解到的以及微软官网上显示的，都是专业版只限企业购买，还需要电话联系销售，我看着好像还挺麻烦的样子。但实际操作下来，发现还是自己信息太闭塞，购买起来其实非常简单，直接通过自带的 Microsoft Store 应用购买即可。

购买流程

在 Windows10 设置的「激活」页面直接有转到 Microsoft Store 购买的选项，点击会直接打开自带的 Microsoft Store 并跳转到专业版的详情界面，价格是 1458 元。

点击「购买」，会先通过微软账户密码确认你的身份，我开启了 Windows Hello 摄像头，直接看一眼摄像头就确认了。

之前买软件的时候已经在 Microsoft Store 中绑定过支付宝的免密支付，所以我的默认支付方式就直接是支付宝。Windows 10 专业版销售商我这里显示的是「杭州网易增盈科技有限公司」，不知道怎么和网易扯上了关系。

最后再点击一次「购买」，支付宝自动完成扣款，加载片刻，Windows 自动激活，显示「Windows 已使用与 Microsoft 账户关联的数字许可证激活」，至此就激活完成了。

更换硬件后如何激活

根据微软官网的信息，在 Windows 10（1607版本或更高版本）中，必须将 Microsoft 帐户与设备上的Windows 10 数字许可证联系起来。通过将 Microsoft 帐户与数字许可证链接起来，以后在进行重大硬件更改，比如换主板的时候，就使用激活疑难解答程序重新激活 Windows。

总结

整个过程非常简单，购买体验挺好。

参考链接

在更换硬件后重新激活 Windows 10

升级背景

之前把博客双部署到了 CODING 静态网站和 GitHub Pages，国内的访问速度快了不少。前几天登录 CODING 后台，突然发现多了一个新版升级提醒。

新版最大的变化就是同腾讯云进行了打通，直接把网站放到了腾讯云的对象存储 COS 上，其他 CDN 加速、SSL 证书管理也是腾讯云的功能。

新版开始收费了

CODING Pages 依托腾讯云资源提供相关静态托管能力，CODING 平台本身不收取任何费用。该产品使用了腾讯云对象存储 COS、内容分发网络 CDN、SSL 证书产品，其中 COS 和 CDN 采用用量计费模式，SSL 证书免费，所使用到的其他相关腾讯云产品本身亦会有一定的免费额度。

新版因为使用了腾讯云的相关资料，所以要开始收费了。对于收费，我是能够接受的，前提是能够提供比免费更好的服务。我的图床就是使用的腾讯云的对象存储，加载速度很快，一个月几毛钱的费用低得基本可以忽略。

升级流程

新版升级界面如下：

因为新版是基于腾讯云的，所以升级需要先在腾讯云进行实名认证并授予相关权限。我因为之前图床就是用的腾讯云对象存储，所以已经实名过了。

之前 CODING Pages 旧版是部署在腾讯云新加坡节点，现在新版部署节点可选香港、北京、上海、广州四个，但未备案域名只能选香港。

添加自定义域名前，需要前往腾讯云开启 CDN 功能，这一步就是我觉得新版最大的坑。

下一步去域名托管商更改解析记录，解析记录值都是指向了 cdn.dnsv1.com，这也是为什么需要开启 CDN 功能的原因。

部署的时候，「网站类型」我最开始选的是「Hexo」，结果部署失败，部署日志也不知道抽啥风，一直显示不出来，原因也不好排查。我尝试将网站类型改为「静态网站」，重新部署就成功了。

这 CDN 不能要

新版升级完成后，立马测了一波速，然后被结果给吓到了，从之前的一片绿油油变成了一片惨淡的黄色，访问速度下降了不止一点半点。这就很费解了，同样都是腾讯云，之前部署在新加坡节点，现在搬到香港节点了，速度不升反降是什么情况。

检查解析 IP，发现域名全都被解析到了德国、爱尔兰、美国，和想象中的香港地址完全不是一回事。

这种情况我估摸着肯定是 CDN 的锅，去腾讯云后台一检查，发现已经开启的 CDN 设置的服务区域是「中国境外」。我想当然地以为「中国境外」的含义是指只有从国外访问网站的时候才会通过 CDN 访问，国内则是直接访问香港源站，这样虽然国内享受不到 CDN 加速，国外我设置是解析到 GitHub Pages，也用不上，但想着无非就是个鸡肋而已。

但一查文档，发现自己还是太单纯了：

「中国境外」:全球用户访问均会调度至中国境外的加速节点进行服务。

也就是说，不管是从国内还是国外访问，都会被调度到国外的 CDN 加速节点进行接入，想不经过 CDN 直接访问香港源站都不行。而比较符合我想要的效果的「全球」则需要域名进行备案之后才能开启，未备案域名开启 CDN 的话就只能选「中国境外」。

本来是用来加快访问速度的 CDN，对于使用未备案域名的博客来说，已经不仅仅是鸡肋了，反而是拖累。本来直接访问香港就能解决的事情，现在非得绕道德国、爱尔兰、美国才行，这访问速度能快起来才是怪事。

尝试直连香港源站

既然这是 CDN 导致的，那我把 CDN 直接给关了，直连香港源站不就行了？

关闭 CDN

进入腾讯云后台–>「内容分发网络」–>「域名管理」，关闭 CDN 加速。

更改域名解析记录

在 DNSPod 里将国内访问解析到 CODING 提供的默认访问地址，此时再检查 DNS 解析结果发现就全部都指向了香港的 IP，达到了自己想要的效果。

致命的证书问题

设置成直接访问香港源站后，速度果不其然就上来了，比访问新加坡节点速度还要快上一点。但很快就出现了一个更加严重的问题——证书错误。

新版申请的 SSL 证书是和 CDN 绑定在一起的，在腾讯云的证书管理里面只能部署到 CDN，而我把 CDN 关闭了，现在直接访问的是香港源站。源站的证书是颁给 *.cdn.my.qcloud 的，和我的域名不一致，这就会导致浏览器直接报警说网站不安全，这是不可接受的。我尝试解决这个问题，但无奈水平有限，最后也没能找到解决的办法。如果有知道如何解决证书问题的同学，麻烦指导我一下，不甚感激。

现在情况就是如果想要实现自定义域名 HTTPS 访问，就需要打开 CDN，打开 CDN 就意味着牺牲访问速度，这还是在 CDN 和 COS 需要付费的情况下。矛盾无法调和，所以最后我只能又回退到旧版了，幸好 CODING 目前还没有关闭旧版的入口，给了我一个反悔的机会。

总结

花了差不多一天的时间，最后还是老老实实回到了旧版，相当于一天白折腾了。域名没有进行备案的话，在国内使用不方便的地方真的太多了。CODING 新版静态网站我觉得对于使用已备案域名的同学来说还是不错的，配置简单，CDN 加速、SSL 证书一步到位。但同样的对于这些同学来说可供选择的方案太多了，免费的也有不少，CODING 的新版并没有太大的吸引力。

而对于未备案域名的同学新版则非常不友好，完全是负优化，完全没有升级的必要，谁会花钱找罪受呢。CODING 工程师说旧版后续会下线，到时候如果自定义域名的问题没有得到改善的话，可能就需要考虑迁移平台了。现在旧版还能用就先用着。

我向 CODING 反馈了自定义域名的问题，希望能同旧版一样使用 Let’s Encrypt 的证书，不要强行同腾讯云的 CDN 加速绑定在一起，后续如果有进一步的反馈结果的话我会同步到博客中。

参考链接

官方静态网站服务升级指南

升级 Hexo 版本

Hexo 核心团队成员 Sukka 写的 Hexo 5.0.0 正式发布详细介绍了 Hexo 5.0 的新特性，以及从 Hexo 4.x 升级到 Hexo 5.x 需要注意的地方。

Hexo 5.0 版本带来了不小的性能上的提升，升级 5.0 直接修改 hexo-site/package.json 文件：

1
2
3

"dependencies": {
-  "hexo": "^4.2.1",
+  "hexo": "^5.1.1",

然后再执行 npm upadte 命令即可。

升级完 Hexo ，_config.yml 并不会更新，而 Hexo 5.0 是有新增和改动一些其中的配置项的，所以需要我们自己去 GitHub 上查看站点配置文件的变动情况，并手动同步这些修改到自己的站点配置文件里。

主要的变动就是新增了 prismjs 相关配置项以及更新了 updated_option 配置项。

升级 Next V8.0.0 版本

使用 Hexo 5.0 及以上版本，升级 Next 主题最简单的方法就是通过 npm 安装，进入博客根目录，执行以下命令即可安装最新版本的 Next 主题：

1

npm install hexo-theme-next

通过 npm 安装的 Next 主题默认文件夹路径为 hexo-site/node_modules/hexo-theme-next 。因为有一些自定义修改可能会需要我们改动主题的源文件，而因为整个 node_modules/ 被gitignore 文件所忽略，将会导致我们无法用 Git 记录我们对主题源文件的修改。

所以我将之前版本的 Next 主题文件夹进行改名，将 hexo-site/theme/next 改成了 hexo-site/theme/next-V7。然后将 hexo-theme-next 文件夹的内容复制到 hexo-site/theme/next 。这样就能将主题文件夹加入 Git 的管理之中了。

这里切记不要直接将旧版本的 Next 主题文件夹直接删除，因为后面可能有配置以及文件需要进行迁移。

更名完成后，使用 hexo version 查看版本号，可以看到一个硕大的 Next Logo 以及下方显示 NexT version 8.0.0，说明现在已经成功启用 Next V8 版本。

迁移配置文件

在之前使用 Next V7 版本的时候，我是利用 Hexo 的 Data Files 功能将主题配置放置在站点的 source/_data/next.yml 文件中。但这种做法在 V8 版本被官方告知已经过时，并将在一段时间后停止支持，现在推荐的做法是使用 Alternate Theme Config 存储配置，需要 Hexo 版本在 5.0 及以上。

这里可以选择一步到位直接将主题配置整合到站点配置文件 _config.yml 中去，也可以选择依然使用独立的主题配置文件，我选择的是第二种。具体流程如下：

创建并配置 _config.next.yml 文件

在博客根目录下新建 _config.next.yml 文件。

因为 Next V8 有不少配置项发生了变更，所以我索性选择了重新配置。先将 hexo-site/node_modules/hexo-theme-next/_config.yml 中的内容复制到 _config.next.yml 中。然后用 Beyond Compare 软件对新主题配置文件 _config.next.yml 和旧主题配置文件 source/_data/next.yml 两者进行文本比较，根据自己的需求迁移整合相关配置项。

修改完成后，将旧主题配置文件 source/_data/next.yml 改名，我是改成了 next-old.yml，名字随意，只要能同原来的 next.yml 区别开来即可。

从 V7 升级到 V8 主要有下面几个变化：

• Hexo 5.0 版本移除了对于 swig 模版的支持，使用 Nunjucks 代替 swig 作为模版引擎，主题配置文件内 custom_file_path 支持文件的后缀也从 .swig 变成了 .njk。所以如果此前根据 swig 的语法写过自定义内容，请在更新前确认它们是与 Nunjucks 兼容的，否则会报错，且生成的页面为空白。例如， Nunjucks 只支持 and 运算符，需要替换掉 swig 中的 &&。
• Next V8 将自带的 Font Awesome 图标库由 4.7.0 版本升级为了 5.13.0 版本。此次升级并不向下兼容，所以需要修改配置文件中与 Font Awesome 相关的内容，否则图标可能无法正常显示。
• NexT V8 已支持一键切换 CDN 服务商，而不需要为每个插件单独设置 CDN 地址。但需要注意，如果是使用最新版的 Next，那么一定要保持 internal: local 的默认设置不变。
• 如果此前配置过 Valine，需要注意将主题配置文件中的 appid 和 appkey 改为 appId 和 appKey 。否则会出现 Valine 无法正常加载的现象。
• 由于 Velocity.js 缺乏维护，NexT V8 使用 Animate.css 代替之。两者的动画效果几乎完全一致，除了动画名称略有不同。如果在配置文件中设置了旧的名称（例如 slideDownIn），请将其移除或根据此网页选择新的动画效果：http://theme-next.js.org/animate/

更多详细信息，可以自行查询 Next 相关官方说明以及官方文档。

迁移 Favicon 位置

之前我博客的 Favicon 图片啥的都是放在 hexo-site/themes/next/source/images 目录下面，正好趁着这次升级的机会，将图片全部移到了 hexo-site/source/images 下（没有这个文件夹就自己新建）。

不要忘记去 _config.next.yml 检查下 Favicon 相关配置的文件名是否正确，默认的都带有 -next 后缀。

自定义修改迁移

这一部分是最麻烦的，因为跨版本升级，很多源文件的位置以及名称都发生了变化，比如每篇文章结尾处的版权声明的样式文件就从 post-copyright.styl 变成了 post-footer.styl。而且模版引擎也从swig 变更成了 Nunjucks，虽然大部分内容是可以互相兼容的，但万一碰到不兼容的，排查起来就比较麻烦了。

所幸我的自定义修改并不多，而且都是 Nunjucks 兼容的，所以迁移起来相对较快。在进行迁移的时候，利用类似 Beyond Compare 之类的文件比较软件可以有效提高迁移速度，推荐大家尝试。

总结

折腾了一天，成功从 Next V7 升级到了 V8，升级所带来肉眼可见的变化并不多，只有一些诸如赞赏按钮样式之类的小变动，其他更多都是内部的一些变动。

我是喜欢自己折腾，而且及时使用新版，可以帮助发现并反馈问题，可以帮助 Next 主题更好地进行迭代。

参考链接

hexo-theme-next README.md

Next 官方文档

Next【必读】更新说明及常见问题

Hexo 5.0.0 正式发布

屏蔽是过时的做法

在前期查找相关资料的时候，我注意到不少博客都建议在 robots.txt 中禁止搜索引擎抓取网站的 JavaScript、CSS 文件，但其中大多数文章并没有给出为什么要这样做的具体理由。

但我觉得现在已经有理由相信这种做法是过时且不必要 的。谷歌在其官方的搜索引擎优化 (SEO) 新手指南中的「让 Google 以用户视角查看网页」章节中明确提到：

当 Googlebot 抓取某个网页时，它应以普通用户查看网页的方式来查看它。为了实现最佳的呈现和索引编制效果，请始终允许 Googlebot 访问您网站所用的 JavaScript、CSS 和图片文件。如果您网站的 robots.txt 文件禁止抓取这些资源，则会直接影响到我们的算法呈现您的内容并将其编入索引的效果，进而导致您的网站排名降低。

可以看到，禁止 JavaScript、CSS 文件的抓取不仅不会对 SEO 有任何正向的帮助，反而可能会起到降低网站排名的负面效果。

至于更具体的理由，谷歌在 Understanding web pages better （也就是上方引用的「以普通用户查看网页的方式来查看它」）中进行了进一步的解释，中心思想可以总结如下：

1. 时代已经变了，JavaScript、CSS 已经变成现代网页不可或缺的一部分了，它们让我们的网页变得更加丰富、更加美观，如果禁止 JS、CSS 被搜索引擎抓取，结果导致网页不能被更好地渲染，这对搜索者以及网站站长双方来说都是一种损失。
2. 为了避免这种双输的局面，我们（谷歌）为此做了很多工作，现在我们（谷歌）的抓取系统已经能够以普通用户查看网页的方式来查看它，而 JavaScript、CSS 代码是普通用户浏览网页时非常重要的组成的部分，所以不要再屏蔽 JavaScript、CSS 文件了。

上面这些都是谷歌在 2015 年就开始提倡的做法，所以现在已经 2020 年了，我们完全可以放心地让搜索引擎抓取我们的 JavaScript、CSS 文件，这样做对 SEO 有百利而无一害。

我的 robots.txt

在博客根目录下的 public 文件夹内新建 robots.txt 文件，然后 hexo d 部署网站即可。

1
2
3
4
5
6

# 允许任何搜索引擎抓取任何页面
User-agent: *
Allow: /
# 站点地图地址
Sitemap: https://asurada.zone/sitemap.xml
Sitemap: https://asurada.zone/baidusitemap.xml

参考链接

谷歌官方搜索引擎优化 (SEO) 新手指南

Understanding web pages better

Don’t block CSS and JS files

配置 User 信息

添加 User 信息

1
2

git config [--global | --local] user.name 'your_name'
git config [--global | --local] user.email 'your_email'

• 默认为 local，所以只有需要设置全局时需要带 –global 参数，–local 参数可以直接省略。
• 单引号不是必须的，可以省略。一般只在输入的内容之中含有空格的时候需要使用单引号。

查看 User 信息

使用以下命令查看所有全局/局部配置信息：

1

git config --list [--local | --global | --system]

或者使用以下命令直接查看具体设置：

1
2

git config [--global | --local] user.name
git config [--global | --local] user.email

global 与 local 优先级以及配置文件所在位置

local > global

local 配置位于当前仓库的 .git 文件夹下的 config 文件中。

global 配置位于当前用户 home 目录下的 .gitconfig 文件中。

独自使用 Git 常见使用场景

git log 常用参数

• git log –all 查看所有分支的历史
• git log –graph 图形化查看 log 历史
• git log –oneline 查看单行的简洁历史
• git log -n 查看最近 n 条历史

删除不需要的分支

普通删除(如果当前分支没有被合并，不能直接删除)：

1

git branch -d 分支名

强制删除：

1

git branch -D 分支名

修改最近一次的 commit 内容

命令：

1

git commit --amend

修改最近一次 commit 的作者

1

git commit --amend --author="AuthorName <email@address.com>" --no-edit

其中 no-edit 的作用是表明此次修改仅修改作者，而不需要对 commit message 进行改动，所以不需要启动编辑器。

修改老旧 commit 的 message

1. 进入交互式变基策略修改：

   1	git rebase -i 想要修改的提交节点的父节点的 HASH 值

   如果想要修改第一次提交，也就是最早的那次提交，没有父节点的提交，使用命令：

   1	git rebase -i --root

2. 修改策略：

   在 vi 模式下将想要修改的 commit 前面的选项由 pick 变更为 r 或者 reword，这一选项的含义为此 commit 的内容不变，只修改其 commit message。

3. 修改 commit message

注意事项：某个 commit 修改后，它本身以及它后面所有 commit 的 hash 值都会发生变化，这是因为message 也是 commit 的属性，是确定 commit 的 hash 值的一个因子。其次，second_commit 有个 parent 的属性，parent 的内容发生了变化，因此，second_commit 的 hash 也变了。

如果最早的提交也即 root commit 发生了变化，那么会产生一个新的 root commit，即出现了两个祖宗 commit。

把连续的多个 commit 整理成一个

1. 进入交互式变基策略修改：

   1	git rebase -i 想要修改的提交节点的父节点的 HASH 值

   如果想要修改第一次提交，也就是最早的那次提交，没有父节点的提交，使用命令：

   1	git rebase -i --root

2. 修改策略：

   将准备被合并的 commit 前面的选项由 pick 改为 s 或者 squash，这一选项的含义为继续使用这一 commit，但是将其合并到前面(比它老)的那一个 commit 里面去，想要合并哪几个就将这几个前面的选项都改成 s。

3. 修改 commit message

把间隔的多个 commit 整理成一个

原理和方法同“把连续的多个 commit 整理成一个”是一样的，只是 rebase 策略的不一样：

• 将想要整理的 commit 通过剪切，按照自己想要的顺序移动到一起，排在上面的是越老的
• 将想要整理的 commit 前面的选项变更为 s
• 最后这些 commit 会同上方最近的一个选项为 pick 的 commit 合并

会用到的 vim 快捷键：

1
2
3
4

dd//剪切一行，也可以用来删除一行
dw//删除一个单词
u//撤销
p//粘贴

比较暂存区和 HEAD 所含文件的差异

HEAD 所含文件就是最新一个 commit 内的文件内容

1

git diff --cached

比较工作区和暂存区所含文件的差异

1

git diff

后面可以接“– 单个或多个文件名”来查看特定文件的差异

比较工作区和 HEAD 所含文件的差异

1

git diff HEAD

让暂存区恢复成和 HEAD 一样

1

git reset HEAD

git reset 默认的参数为 –mixed

让工作区的文件恢复为和暂存区一样

1

git checkout -- 文件名

Git 2.23 版本以后使用 git restore命令来代替git checkout功能

取消暂存区部分文件的更改

将暂存区部分文件取消暂存的意思是所做的改动继续保留在工作目录，暂存区部分的内容同 HEAD 保持一致。

1

git reset HEAD --文件名

Git 新版本使用：

1

git restore --staged <file>

两条命令作用是一样的。

消除最近的几次提交

1

git reset --hard <hash>

将工作区和暂存区的内容都恢复到 hash 值所对应的那个 commit 的状态。

看不同提交的指定文件的差异

1

git diff [from_commit] [to_commit]

正确删除文件的方法

1

git rm <filename>

本地与远程仓库的交互

让 Fork 的仓库同源仓库保持更新

添加源仓库

1

git remote add upstream 源仓库链接

同步更新

1. 如果在另一个分支上，就切换到 master 分支

1

git checkout master

2. 从源仓库抓取最新更改后，合并到本地 master 分支

1

git pull upstream

3. 将本地 master 分支推送到自己 Fork 的远程仓库 origin

1

git push origin

进阶版

1. 将 master 分支的上游仓库设置为源仓库

1

git branch --set-upstream-to=upstream/master master

2. 将 push 命令推送的默认仓库设置为自己 Forked 的仓库 origin

1

git config --local remote.pushDefault origin

3. 搞定之后，工作流程为更加简单：

1
2
3

git checkout master
git pull//默认从源仓库拉取最新的更新
git push//将拉取的更新推送到 Forked 的仓库

推送一个新的分支到远程仓库

-u 是 –set-upstream 的简写，该标记会为之后轻松地推送与拉取配置分支

1

git push -u remote_name new_branch_name

清理本地无效的远程追踪分支

利用选项 –prune

1

git remote update -p

远程删除了分支本地也想删除

1

git remote prune origin

删除远程分支

1

git push origin --delete <remote-branchname>

或者

1

git push origin :<remote-branchname>

从远程分支中创建并切换到本地分支

1

git checkout -b <branch-name> <remote-name>/<branch-name>

参考链接

Git的奇技淫巧

生成站点地图

什么是站点地图？

站点地图是一种文件，您可以在其中提供与您网站中的网页、视频或其他文件有关的信息，还可以说明这些内容之间的关系。Google 等搜索引擎会读取此文件，以便更加智能地抓取您的网站。站点地图会告诉 Google 您认为网站中的哪些网页和文件比较重要，还会提供与这些文件有关的重要信息：以网页为例，这些信息包括网页上次更新的时间、网页更改的频率，以及网页是否有其他语言版本。

谷歌帮助-了解站点地图

安装 hexo-generator-sitemap 插件：

1

npm install hexo-generator-sitemap --save

安装插件以后，执行 hexo g 命令，即可在 public 文件夹下找到新生成的 sitemap.xml 文件。

让百度收录站点

百度验证域名

刚建站的时候，百度是没有收录我们的网站的，这时在搜索框输入 site:<域名> ，结果应该是下面这样的，点击「提交网址」来提交我们的站点。

点击后会进入「百度搜索资源平台」，用自己的百度账号进行登录。登录后「站点管理」–> 「添加站点」–> 「添加网站」。

百度添加网站是需要进行实名认证的，这一点需要注意。

填完个人信息后，提交站点网址，选择站点属性，最后一步验证网站。

验证方式选择第二种「HTML标签验证」，复制下图 content 里的字符串。

此项配置基于 Hexo 4.2，Next 7.8.0

打开主题配置数据文件 next.yml ，搜索 baidu_site_verification，将上述字符串填至后方。

1
2
3

# Baidu Webmaster tools verification.
# See: https://ziyuan.baidu.com/site
baidu_site_verification: hpYpGBuDQF

执行 hexo g -d 重新生成并部署站点，部署完成后，检查网站源码，能看到在<head> 里面已经自动包含了用于验证身份的 meta 标签：

回到百度站长管理平台点击「完成验证」按钮，完成验证。

当我验证完成的时候，百度通知我说 HTTPS 认证失败，当时我没有进行任何处理，二个小时后我手动在「搜索展现」–> 「HTTPS 认证」申请认证，几分钟后就直接显示「认证通过」了，所以认证失败了不要慌，可能等待一会就自然好了。

百度提交链接

百度提交链接有下面三种方式。

主动提交

安装 hexo-baidu-url-submit 插件：

1

npm install hexo-baidu-url-submit --save

获取百度主动推送准入密钥并复制：

在站点配置文件 _config.yml 中新增以下代码：

1
2
3
4
5
6

+ # 百度主动推送
+ baidu_url_submit:
+ count: 5 # 提交最新的五个链接
+ host: https://asurada.zone # 在百度站长平台中注册的域名
+  token: xxxxx  # 请注意这是您的秘钥， 所以请不要把博客源代码发布在公众仓库里!
+  path: baidu_urls.txt  # 文本文档的地址， 新链接会保存在此文本文档里

然后在站点配置文件 _config.yml 中修改部署策略：

1
2
3
4
5
6
7
8
9
10
11

  # Deployment
  ## Docs: https://hexo.io/docs/deployment.html
- deploy:
- type: git
-   repo: git@github.com:ousugo/ousugo.github.io.git
-branch: master
+ deploy:
+ - type: git
+   repo: git@github.com:ousugo/ousugo.github.io.git
+branch: master
+ - type: baidu_url_submitter # 百度

此后每次执行 hexo d 部署博客的时候将会自动在 ./public 目录下生成 baidu_urls.txt 文件，里面的内容就是自己设置的最新的 n 条文章链接。然后自动推送文件内容到百度，加快链接被百度收录的速度。

在这里的时候我踩了一个坑，在部署的时候一直提示错误：{"error":401,"message":"site sid is empty"} ，后面经过排查发现是在配置主动推送时，host 后面的网址没有加协议头，加上之后就不报错了。

1
2
3
4
5
6

baidu_url_submit:
  count: 5 # 提交最新的五个链接
- host: asurada.zone # 在百度站长平台中注册的域名
+ host: https://asurada.zone # 在百度站长平台中注册的域名
  token: xxxxx  # 请注意这是您的秘钥， 所以请不要把博客源代码发布在公众仓库里!
  path: baidu_urls.txt  # 文本文档的地址， 新链接会保存在此文本文档里

自动推送（弃用）

此项配置基于 Hexo 4.2，Next 7.8.0

Next 主题中已经内置了一键开启百度自动推送的选项：

1
2

# Enable baidu push so that the blog will push the url to baidu automatically which is very helpful for SEO
baidu_push: true

开启后将会自动在页面中添加如下脚本用于百度推送：

之后每次访问站点页面都会通过以上脚本将当前页面的 URL 推送到百度。

sitemap

安装 hexo-generator-baidu-sitemap 插件：

1

npm install hexo-generator-baidu-sitemap --save

插件安装成功后，执行 hexo g -d 部署网站，然后访问 网站自定义域名/baidusitemap.xml 检查百度网站地图是否正常。比如我的是 asurada.zone/baidusitemap.xml 。

然后来到百度站长平台的 sitemap 提交页面，提交 sitemap 地址即可，注意需要自己添加 https:// 协议头，不然默认是 http://，会导致抓取失败。

初次提交要等几分钟，如果成功的话状态会显示为正常，并显示成功提取 URL 的数量。如果以后博客有新的文章或其他页面，可以点击手动更新文件，对 sitemap 进行更新。

百度的收录速度是比较慢的，一两周都是很正常的。

让谷歌收录站点

GSC 验证域名

登陆 Google Search Console （后面简称 GSC)，可以看到有两种资源类型，因为目前我博客的域名是没有任何前缀的裸域名，所以我选择「网域验证」。

要进行「网域验证」的话，只有「通过 DNS 记录来验证域名所有权」这一种办法。复制这一步中出现的 TXT 记录值，然后进到域名解析服务商的管理界面，比如我的是 DNSPod。

在「记录管理」里面新增一条 TXT 类型的解析记录，主机记录留空或者填 @，记录值就是刚刚复制的那一串记录值，其他保持默认即可。

稍等片刻，等待 DNS 解析生效，然后回到 GSC 点击「验证」按钮，即可完成验证。

提交站点地图

验证域名所有权之后，进入 GSC 后台管理界面，输入 sitemap 地址并点击提交即可。谷歌的收录是比较快速的，两天左右就能够在谷歌通过 site:博客网址 的方式检索到收录结果了。

让 360 搜索收录网站

注册 360 站长平台

注册并登录360 站长平台，添加网站。

添加网站后需要进行验证，选择「代码验证」，复制 content 后的字符串，后面会用到。

360 验证域名

修改站点配置文件 _config.yml ：

1
2
3
4
5
6

# Define custom file paths.
# Create your custom files in site directory `source/_data` and uncomment needed files below.
custom_file_path:
- #head: source/_data/head.swig
+ head: source/_data/head.swig
  #header: source/_data/header.swig

然后在 博客根目录\source\_data 下新建 head.swig 文件，然后打开并新增以下内容：

1
2
3

{% if theme.so_site_verification %}
  <meta name="360-site-verification" content="{{ theme.so_site_verification }}"/>
{% endif %}

上面代码是利用了 Next 主题的 Inject 功能，以上代码的含义为如果在 _config.yml 中存在 so_site_verification 这一设置项，则会将 <meta name="360-site-verification" content="so_site_verification 设置项的 value"/>插入到网站首页 HTML 代码的 <head></head> 标签中。

再次修改站点配置文件 _config.yml，在 SEO Settings区域新增以下内容 ：

1
2
3

# 360 Webmaster tools verification.
# See: zhanzhang.so.com/sitetool
so_site_verification: 此处填写之前复制的验证字符串

修改完成后，执行 hexo g -d 命令重新生成并部署网站，部署生效后，回到 360 站长平台，「点击验证」即可。如果网站已经开启了 HTTPS 访问，不要忘记「设置 https」。

提交 sitemap

360 站长平台体验很一般，连 HTTPS 都没上，然后在进行 sitemap 提交的时候，第一天页面就一直报「连接超时」，完全无法提交。第二天终于不报错了，可以正常提交了，页面也显示成功提交，但添加完以后 sitemap 列表却一直是空的，让人很困惑，不知道这到底是添加成功了但还没爬取呢还是压根就没添加上。终于第三天一切顺利，成功添加并显示了。

我一开始提交的是只有裸域名的 sitemap 地址，但是几天后发现无法抓取到任何链接，于是我尝试在域名前加上 www，没想到还真有效果，很快就把全部链接都给抓取到了。具体的原因目前我也没有弄清楚。

让搜狗收录网站

注册搜狗站长平台

注册并登录搜狗站长平台，我在这里很想吐槽，这都 2020 年了，360 和搜狗的站长平台居然都还没上 HTTPS，我一度怀疑自己是不是进了伪造网站。这样给我的感觉就是完全没有用心在做搜索。

搜狗的添加网站也和别家不一样，很奇葩地单独设置在「用户中心」里，体验上很割裂。

搜狗验证域名

填加网站后同样需要验证，这次我们图省事，直接选择「文件验证」，点击「下载验证文件」，将 sogousiteverification.txt 下载到 博客根目录\public 文件夹里面，然后直接执行 hexo d 命令部署网站，部署生效后，回到搜狗站长平台「完成验证」。

提交链接

搜狗站长平台居然不支持 sitemap 提交，说是采取邀请制，这波操作反正我是看不懂。

那只能退而求其次，手动提交链接了，得亏是我现在文章还比较少。不过倒可以等文章更多一些，试着申请一下开通 sitemap 提交权限。

让 Bing 搜索收录网站

Bing 我之前并没有申请过收录，但是在使用 site:asurada.zone 检查收录情况时，居然惊喜地发现已经收录了我的博客，虽然仅仅只有一条链接。

直接从 Google Search Console 导入网站

打开Bing Webmaster，使用绑定了 Google Search Console（后面简称 GSC） 的谷歌账号登录，这样后面就可以很方便地直接从 GSC 直接导入网站，而不需要再单独验证网站。

提交网站地图

按理说应该可以直接从 GSC 获取网站地图，但我的并没有获取到，不管了，手动提交也很简单。Bing 处理 sitemap 的时间大概在一天左右。

让 Yandex 搜索收录网站

注册 Yandex Webmaster

注册并登录Yandex Webmaster，这里有一个坑需要注意，Yandex 目前是可以直连的，但是在注册账号的时候，你会发现在最后一步输入验证码的时候，不管你怎么填总会提示验证码错误。而且 Yandex 的验证码是很奇葩的两张图片，让我弄不清楚是该输其中一张图片的内容还是怎么着，折腾了半天。最后在网上查到的解决方法是不要直连，而是通过科学上网进行注册，这时再输验证码就不会报错了，无语，验证码是两张图片的内容都要输入。

Yandex 验证域名

此项配置基于 Hexo 5.0.2，Next 7.8.0

进入 Webmaster 后台管理界面添加域名，这里需要注意的是和在其他站长平台添加网址不一样，Yandex 在添加网址时就需要写清楚带不带 www，是使用 http 还是 https，默认是使用 http 的。

选择域名验证方式，因为 Next 主题直接内置 Yandex 的验证，所以我们选择「Meta tag」验证，复制 content 后双引号内的字符串。

打开 Next 主题配置文件 next.yml，搜索关键字 ”Yandex”，找到yandex_site_verification，填入刚刚复制的字符串。

1
2
3
4

# Yandex Webmaster tools verification.
# See: https://webmaster.yandex.ru
- yandex_site_verification:
+ yandex_site_verification: 4aca0e5ccd3fbc2f

修改完成后，执行 hexo g -d 命令重新生成并部署网站，部署生效后，回到 Yandex Webmaster，点击 “Check” 即可。

提交 sitemap

验证完成后，在左侧菜单「Indexing」–> 「Sitemap files」中提交 sitemap ，然后等待两天时间即可完成 sitemap 的收录和牵引。

之后就可以在左侧菜单「Indexing」–> 「Searchable pages」中查看网站的哪些页面已经被 Yandex 搜索引擎所收录。

让头条搜索收录网站

注册头条站长平台

注册并登录头条搜索站长平台，添加网站。

头条验证网站

头条现在的验证方式非常单一，只能通过「文件校验」的方式来验证。直接下载验证文件并将其移动到博客根目录下的 public 文件夹里面。然后执行 hexo d 命令部署网站，部署生效后，回到站长平台完成验证。

提交 sitemap

验证完毕后，提交 sitemap。

提交完成后，即可在页面下方查看 sitemap 的更新情况：

让神马搜索收录网站

注册神马站长平台

注册并登录神马搜索站长平台，添加网站。

验证网站

直接下载验证文件 shenma-site-verification.txt 并将其移动到博客根目录下的 public 文件夹里面。然后执行 hexo d 命令部署网站，部署生效后，回到站长平台完成验证。

放弃神马收录

神马在验证网站时，不管是文件验证还是代码验证，我多次尝试都以失败告终，使用体验极差，遂弃之。

总结

各大搜索引擎的收录步骤都是大同小异的，没啥太大的难度，一步步来就可以了。

整体体验下来，感觉搜狗、神马压根就没想把自己的搜索给做起来了，体验一塌糊涂。360 体验稍好一点，不过作为国内搜索的老二，站长平台连个 HTTPS 都不上，属实说不过去。相较于国内参差不齐的体验，国外主流搜索引擎的站长平台的各种体验都要好上不少，人家强是有道理的。

最后想说的，也是对自己的勉励，那就是「内容才是第一要素」。SEO 技巧是为内容服务的，收录只是第一步，收录以后还需要持续更新博客，写有价值、有内容的文章，这样才能吸引他人点击和浏览，乃至分享引用，这样可以增加网站曝光以及提高搜索引擎权重，从而得到更好的搜索引擎排名，让更多的人看到，实现正向循环。

参考链接

Hexo-NexT 博客提交搜索引擎收录

Hexo 博客提交百度、谷歌搜索引擎收录

中文博客的受众肯定是以国内为主，但部署在 Github Pages 上，服务器在国外，国内访问的速度太不稳定，如果一个页面需要将近十秒才能完全打开的话，用户体验差，页面被提前关闭的概率也会呈指数级上升。所以改善国内访问体验迫在眉睫。

之前也想过直接使用 CDN 直接加速 GitHub Pages 的方式，但国内的 CDN 全部要求域名进行备案，嫌麻烦就放弃了。最后选择通过将博客同时部署到 GitHub 和 CODING 的方式来提升国内访问体验。

CODING 在 19 年年底进行了一次比较大的改版，双部署的整个流程也有了不小的变化，而网络上很多教程大部分都还是基于旧版流程的。本文详细记载了将博客同时部署到 GitHub Pages 和 CODING 静态网站服务的全流程。

CODING 配置

注册 CODING 账号

2019 年 12 月 28 日以后，CODING 统一了入口，不再区分个人版与否，具体的升级详情可以查看官方通知。升级后的 CODING 会增加「团队/组织」的管理概念，注册的时候必须先创建一个团队，这个和平常的注册稍有些不同，需要注意一下。点击跳转 CODING 官网。

创建 CODING 项目

注册成功以后，进入「项目」–> 「创建项目」。

选择「代码托管项目」，只需填写项目名称，其他都保持空白和默认即可。注意不要勾选「公开源代码」。

CODING 配置 SSH 公钥

SSH 密钥设置的路径为 「右上角个人头像」–>「个人账户设置」–> 「SSH 公钥」–> 「新增公钥」。

新增密钥是敏感操作，所以在新增密钥的时候，CODING 会要求验证密码才能添加，需要注意的是这里要求验证的是服务密码，而不是登录密码。如果没有事先设置服务密码的话，需要先在「个人设置」–> 「服务密码」进行设置。

添加公钥后，打开 Git Bash，使用以下命令验证是否配置成功：

1

ssh -T git@e.coding.net

因为是第一次进行连接，所以需要输入 yes 来确认进行连接。配置成功，会出现如下图所示的提示：

部署 CODING「静态网站」

配置站点配置文件 _config.yml

进入到 CODING 上刚才新建的项目里面，选择「代码仓库」，可以看到此时代码仓库还是空的，选择「SSH」链接方式并复制链接。

打开博客根目录下的站点配置文件 _config.yml ，修改其中的 deploy 区域，将刚复制的 SSH 链接新增进去：

1
2
3
4
5
6
7

deploy:
  - type: git
    repo: git@github.com:ousugo/ousugo.github.io.git
    branch: master
+ - type: git
+   repo: git@e.coding.net:asuradazone/asurada/asurada.git
+   branch: master    

部署代码到 CODING

_config.yml 文件修改完成后，执行 hexo d 命令进行部署，此时 Hexo 就会根据设置同时将博客部署到 GitHub 和 CODING 上面。

此时再进入 CODING 上的项目，能看到刚才还是空的仓库现在已经有源代码了，说明部署是成功的。

项目启用「持续部署」功能

CODING 改版后，开启 Pages 服务的方法有了较大的变化，连名字都改了，现在已经不叫「Pages 服务」，而是改叫「静态网站」了。

「静态网站」是「持续部署」下面的一个子功能，而「持续部署」功能默认是没有开启的，需要我们自行启用。启用路径为项目左下角「项目设置」–>「项目与成员」–>「功能开关」–>「持续部署」。

「持续部署」功能开启后，就可以在它下面找到「静态网站」了。为了后续方便操作，还可以点击「静态网站」字样右边的按钮将其固定到项目选项顶部。

实名认证

CODING 现在要求是必须先进行实名认证以后才能使用「静态网站」的服务，实名认证的入口在「右上角头像」–>「团队管理」–>「团队设置」–>「高级设置」里面，藏得有点深。

如果没有绑定手机号的话，需要先绑定手机号才能进行实名认证，反正现在基本想要使用国内的服务，实名认证基本是跑不掉的。输入姓名和身份证号码即可完成认证。

发布静态网站

实名认证完成后，点击「立即发布静态网站」，填写「网站名称」，「触发机制」默认为「自动触发」，此后每次同步代码到 master 分支时，网站即会自动部署。所有设置保持默认即可，然后点击「保存」。

设置保存后，刷新页面，会看到 CODING 已经自动生成了网站的访问链接，不过现在网站还没有正式部署，还需要我们点击「立即部署」来部署网站。部署完成后就可以点击链接查看网站部署效果了，应该同部署到 GitHub Pages 是同样的效果。

绑定自定义域名

我的自定义域名是在 NmaeSilo 买的，主要优点有：

1. 支持支付宝付款
2. 赠送 WHOIS 域名隐私保护
3. 第一年价格相对实惠

如果有同学也考虑在 NmaeSilo 购买域名，欢迎使用我的优惠码 Asurada ，可以优惠一美元。

修改域名解析服务到 DNSPod

之前博客只部署在 GitHub Pages 上时，因为不需要考虑国内外解析分流，所以我直接使用的是 NameSilo 默认的域名解析服务。现在博客分别部署在 GitHub 和 CODING 上了，我希望将国外的流量解析到 GitHub，国内的流量则解析到 CODING，但 NameSilo 默认的域名解析服务并不能实现国内外流量的区分，所以需要更换域名解析服务商。

我日常使用腾讯云比较多，所以选择了腾讯旗下的 DNSPod，账号和腾讯云是通用的，直接微信扫码即可登录。登录到 DNSPod 控制台，在「DNS 解析」–>「我的域名」里添加想要解析的域名。因为还没有修改域名注册商那边的设置，所以现在显示的状态还是「DNS 错误」。

登录到 NameSilo 后台，在「Account Options」中选择「domain manager」，选中想要进行修改的域名，点击上方「Change Nameservers」图标。

将默认的 DNS 服务器地址修改为下面的 DNSPod 提供的 DNS 服务器地址，然后提交修改。

1

f1g1ns1.dnspod.net

1

f1g1ns2.dnspod.net

DNS 域名解析服务的修改后需要等待全球递归 DNS 服务器的刷新，所以需要耐心等待一会儿，大概十分钟左右。修改生效后再手动刷新 DNSPod 的状态，注意不是刷新页面，而是点击「DNS 错误」旁边的感叹号获取新状态，此时应该状态会变为「正常」。状态正常后，点击域名，进入「记录管理」。

DNSPod 解析记录设置

先简单介绍一下 A 记录 和 CNAME 记录 的作用：

如果需要将域名指向一个 IP 地址，就需要添加A记录；

如果需要将域名指向另一个域名，再由另一个域名提供 IP 地址，就需要添加 CNAME 记录。

我们一共添加五条解析记录，其中三条境外，两条境内，具体记录如下：

第一条记录类型为 A，主机记录为 @，解析线路选择默认，记录值为 CODING 静态网站的 IP 地址，可以使用 ping 命令查询得到。比如 CODING 替我自动生成的网站访问地址为 http://quj3xn.coding-pages.com/，打开 cmd，输入 ping quj3xn.coding-pages.com，就可以得到 CODING 静态网站的 IP 地址，我的是124.156.205.241， TTL 的话，免费版最小只能填 600。这条解析记录的意思是将从境内访问 asurada.zone 的流量解析到 124.156.205.241。

第二条记录类型为 CNAME，主机记录为 www，解析线路选择默认，记录值为 CODING 自动生成的访问地址，比如我的是 quj3xn.coding-pages.com。这条解析记录的意思是将从境内访问 www.asurada.zone 的流量解析到 quj3xn.coding-pages.com。

接下来的三条境外解析记录就很好理解了，第三和第五条记录是分别将从境外访问 asurada.zone 的流量解析到 185.199.108.153 和 185.199.109.153，这两个 IP 都是 GitHub Pages 的服务器 IP 地址。第四条记录则是将从境外访问 ww.asurada.zone 的流量解析到 ousugo.github.io。

DNSPod「搜索引擎优化」

在「域名设置」–> 「功能设置」里有一个「搜索引擎优化」功能，默认是关闭的，说是和各大搜索引擎有深度合作，开启后可以优化站点收录，具体原理咱也不知道。但这是一个免费功能，所以不开白不开。

根据官方文档，主流的搜索引擎都在优化范围之内，看上去还是很不错的：

CODING 绑定自定义域名并开启 HTTPS

进入 CODING 项目的静态网站设置页面，向下滚动找到「自定义域名」的设置项，绑定自定义域名。如果在绑定域名时出现证书申请错误：

申请错误原因是：在验证域名所有权时会定位到 GitHub Pages 的主机上导致 SSL 证书申请失败

正确的做法是：先去域名 DNS 把 GitHub 的解析暂停掉，然后再重新申请 SSL 证书，大约十秒左右就能申请成功，然后开启强制 HTTPS 访问

— 绑定域名并开启 HPPTS

建议同时绑定有 www 前缀和没有 www 前缀的域名，并根据自己的需求将其中一个设为首选域名，另一个勾选「跳转至首选」选项，这样可以避免一些第三方服务数据统计不到一起。

如果两个域名的证书都没有问题的话，点击「强制 HTTPS」按钮即可启用强制 HTTPS 访问。设置完成后，不要忘记去 DNSPod 将之前暂停的 GitHub 解析重新开启。

成果检验

至此，我们完成了博客在 GitHub Pages 和 CODING 静态网站服务上的双线部署。

首先进行 DNS 的查询，可以看见结果正如我们所期望的，从国内访问的时候走的是 CODING 的静态网站服务，而从境外访问的时候走的则是 GitHub Pages。

最后自然是喜闻乐见的速度对比，这里使用的是站长之家的国内网站测速工具。这里我们测试的域名分别是 CODING 和 GitHub 自动生成的网站域名，多次测试下来，结果稍稍有些出乎我的意料，CODING 并没有如我想象的那样取得全面的、压倒性的速度优势，在部分地区反倒是 GitHub Pages 的访问速度更快。不过在多次测试中，CODING 的平均响应时间都比 GitHub 要快上三百到五百毫秒不等。

但如果是直接测试自定义域名 asurada.zone 的国内访问速度的话，分别设置域名仅解析到 CODING 和 GitHub，这时候可以看到解析到 CODING 时的国内访问速度明显比解析到 GitHub 时要快上不少。

我猜测出现这种情况可能是 DNSPod 解析的功劳——当直接使用 quj3xn.coding-pages.com 域名进行测速时，DNS 解析的速度比较慢，进而拖累了整体的访问速度，而当使用自定义域名 asurada.zone 进行测速时，此时由 DNSPod 负责进行域名解析，解析速度比较快，进而加快了整体的访问速度。

我们更在意的自然是使用自定义域名访问时的速度，可以看到双线部署对于自定义域名的国内访问速度的提升效果是非常明显的，这次折腾也算是圆满成功，完结撒花✿✿ヽ(ﾟ▽ﾟ)ノ✿。

参考链接

CODING 静态网站服务官方文档

Hexo 博客部署到 Coding

Hexo 双线部署到 Coding Pages 和 GitHub Pages 并实现全站 HTTPS

文章内容信息的时效性只能保证到我自己办理结束的 19 年 12 月份，最新的要求以及相关消息还是以招商银行官网、官方客服、官方公众号的通知为准。

本文只是分享一点个人的经验，希望能够帮到有需要办理招行香港银行卡的朋友。

为什么选择招行香港银行卡

亲赴香港开户的话，有很多银行可供我们选择，我本人之所以选择招行香港主要有以下几个原因，列出来仅供参考，大家可以根据自己的需求选择最适合自己的银行办理开户。

支持银证转账券商较多

逛券商官网的时候，发现支持银证转账的银行里面出现次数最多的就是民生香港和招行香港，而银证转账对于资金的快速调度还是很重要的，同时也是我个人比较看重的一点。民生香港和招行香港都同时支持富途、华盛通、有鱼三家券商的银证转账，招行香港仅比支持券商数量最多的民生香港少支持了一家我并不用的玖富。

银证转账券商支持情况一览

而民生香港在内地开户根据不同地域是有不同资金门槛的，最低也需要五万人民币，就算亲临香港开户同样也是需要五十万港币的资产证明，而招行香港亲临香港办理无任何资金门槛。

招行香港内地有资金门槛

招行香港一卡通内地见证开户设有五百万人民币的资金门槛，在此就不做讨论了，只讨论亲临香港办理的情况。

招行香港优点

1. 支持银证转账的券商较多，仅比最多的民生香港少一家玖富
2. 亲临香港办理无需任何资产证明
3. 账户管理费相对较低，只需日均资产达五千港币即仅需十港币/月。与之相比，民生香港要日均资产达一万港币才只收十港币每月，永隆则是日均资产达不到一万港币收取每月一百港币，一万港币以上免收管理费
4. 开户无需提前预约，对应的则是现场取号后可能需要排队一到两个小时
5. 万一赴港才发现资料有问题，后续新资料可以通过邮寄方式提交，无须多次亲赴香港

招行香港缺点

1. 账户不能即开即用，可能需要一到两个工作日时间审批，实体卡需要另行寄送
2. 手机 App 功能不全，银证转账等操作需要使用电脑版或者网页版网银，没有直接在手机上操作方便
3. 网点只在工作日上班，上班族需要请假才能办理

综上我个人最后选择了办理招行香港银行卡。

赴港前准备

去一次香港对住得远的朋友来说并不是一件轻松的事情，路途所需花费的时间和金钱都不算少，肯定希望一切顺利。而想要一切顺利，前期充分的准备工作是必不可少的。

准备所需文件

所需文件的最新情况以官网 香港一卡通开户指引及业务咨询 为准。可以自行拨打招行客服电话 95555，转接人工客服直接咨询办理香港一卡通相关文件要求，再次提醒文章内提到的信息有效期只保证到 2019 年 12 月份。

1. 身份证明文件——港澳通行证以及身份证

需要注意的就是港澳通行证以及身份证的剩余有效期都需在六个月以上，需要多提醒一句的是证件的有效期，港澳通行证上有证件以及签注两个有效期，只需要证件有人像那一面的证件有效期剩余在六个月以上即可。

2. 地址证明

这个地址证明是不少人不清楚的地方，其实官网上面对住址证明的要求写得很清楚，我们啥事都是尽量以官网为准。

需要注意的是上方表格里面有提到居住证，但深圳的居住证是不行的。

一般都是用的信用卡账单，而且自己打印的是不可以的，必须要是去银行网点打印或者银行直接寄送的纸质账单，我用的是招行直接寄送的纸质账单，纸质账单一般直接打信用卡人工客服要求寄送即可。

信用卡账单上面的地址是可以自己任意更改的，但需要注意的是你所填写的这个地址就是将来实体卡片寄送的地址，所以务必填写能够确保自己收到卡片的地址；再一个就是对地址的精确性是有要求的，是要求精确到门牌号，比如某某小区XX栋XX单元XXX号，如果不够详细，柜员是可能要求你重新提供合格的地址证明的。但其实住址的真实性银行是不做核查的，你只填到能够确保收到银行卡的地址也是可以的，比如XX小区XX号，在柜员询问的时候肯定回答这就是你目前的地址即可。

但请注意，公司类地址是不行的，这个是官网上明确规定不行的，必须要是住宅类地址。

如果你有更加硬核的居住证明，比如房本之类的，自然也是可以的。我去办的那天，有对夫妇就没有带地址证明，然后直接了掏出一个红澄澄的房本。

3. 内地招行储蓄卡

这个如果没有的话，自己带身份证到内地招行任意网点开一张就好，没什么要求，普通的储蓄卡就行，而且里面是不要求有钱的。现在内地银行开卡都是自助机器就搞定了，很快的。

4. Ukey(U 盾)

内地招行默认给你开通的网银是大众版网银，而 Ukey 是专业版网银才有，也就是说你办理储蓄卡默认是不会给你 Ukey 的，Ukey 需要另外申请。

带身份证、招行储蓄卡去网点就可办理，不需要预约，去之前注意打电话或者在招行 App 里查看一下网点的工作时间，有些网点是周六不上班，周日才上班。申请的时候，柜员会问你申请的目的，直接说开通香港一卡通需要用就可以。费用的话是 20 元人民币。

这个拿到以后，回去在招商银行官网上下载「专业版网银」，然后按提示激活 Ukey 即可。

Ukey 长这个样子：

5. 所需文件一览：

• 身份证(剩余有效期六个月以上)
• 港澳通行证(证件剩余有效期六个月以上)
• 住址证明(纸质信用卡账单)
• 内地招行储蓄卡
• Ukey

事先填单

你到了招行香港网点，开户也是需要在内地的「招商银行」App 内在线填写开户资料的，而这个资料的有效期是 30 天，也就是说你完全可以事先在内地就把开户申请填完，然后只需在填写完成以后的三十天内前往招行香港网点办理就行了，这样你一到招行香港网点就可以立即取号，办理招行香港银行卡全程耗费时间最多的就是在等叫号的时候，能早一个号就大概能节约半小时，所以强烈建议事先填好开户申请单。

填单路径为「招商银行」 App 首页 -> 点击「全部」 -> 选择「办卡开户」 -> 点击「香港一卡通」

需要填写的内容还挺多的，如实填写即可。

填写时有一个港澳通行证证件号码，这一个号码是港澳通行证有人像那一面右上角那一个九位的以字母开头(新版都是以 C 开头的)的号码。

在填工作单位信息的时候，一定不要乱填，原因见下一段。

另外还需要提前下载好天眼查或者企查查的 App，因为开户时大堂经理以及柜员会要求你出示你填写的工作单位所对应的天眼查或者企查查的查询页面，主要是为了核对你所填写的公司地址和实际查询页面上的是否一致。

出现下图所示页面即代表申请成功，这个页面最好截下屏，后面可能取号的时候需要出示给招行香港大堂经理看，不截问题也不大。

了解网点相关信息及其他准备

1. 招行香港网点地址及营业时间

网点地址：招行香港有且仅有「香港中环康乐广场八号交易广场三期28楼」这一个网点。至于怎么过去，我是直接坐高铁到香港西九龙，然后转地铁去的，具体怎么走会在后面的章节里面详细说。

营业时间：工作日 9：00-17：00，周六日及香港假期不营业。注意香港假期和内地假期并不一致，去之前一定要确保网点处于营业时间。最新消息可以微信关注招行香港官方公众号「招商银行香港分行HongKong」，一切消息以官方为准，如果有假期的话，官方也会提前在这个公众号推送消息的。

招行香港开户是不需要提前预约 的，你可以在任意营业时间去开户。不过因为不需要预约，所以是需要现场取号排队的，这就意味着你需要在现场等你前面的人办完业务，这个等待的时间可长可短，我当时是上午十一点半取号，下午一点二十才轮到我，排我前面大概四五个人，所以早点去总没错的。

2. 开通手机漫游功能及准备当地上网卡

去之前通过对应内地手机运营商客服热线或是 App 开通国际漫游功能，确保抵达香港后手机能够及时接听电话及短信，以备不时之需。移动的话，打和接电话都是 0.99 元/分钟，短信发内地 0.69 元/条，收短信免费。

在香港上网的话，我是办理的微信的 WeSim 卡(非广告，人家也不可能给我广告费)，9.9 元有 500M 4G 流量，一般来说不看视频，刷刷微信、查查资料，办银行卡一天差不多够用了，不够用直接再在公众号上买一个流量包就行，非常方便。另外这个卡我实测是可以直接科学上网的，WeSim 自己的宣传页面讲得还比较含蓄，只说可以正常使用谷歌地图。相关使用指南以及更多购买信息直接微信关注「WeSim 小助手」公众号即可。当然其他淘宝上卖的当地上网卡也是可以的，淘宝上很多还可以直接打电话，我这里只是讲一下自己使用的而已。

WeSim 已于2020年6月8日停止服务。

3. 充电宝及充电线

这个就不需要多解释了，带个容量大一点的，以备不时之需总没错的。

4. 高德地图

高德地图在香港也是可以用的，人生地不熟，一个好用的地图是必须的，建议事先在内地就离线好香港地图，节约流量。可以提前在高德地图上搜索「招商银行(香港分行)」即可找到具体地点，然后收藏备用。这里再次提醒招商银行(香港分行)在香港有且仅有一个分行，地址是「香港中环康乐广场八号交易广场三期28楼」。另外「招商银行(香港分行)」和「招商永隆银行」不是一家银行，虽然两者名字里面都有一个「招商」，后者是招商银行 2008 年收购香港本地的「永隆银行」后于 2018 年改名的，请注意区分，不要导航导错了。

赴港注意事项

如果是第一次去香港的朋友，可能有以下几个需要注意的地方。

一地两检

入境香港时，是西九龙下车后，内地先检一遍，然后香港那边再检一遍。内地检完过了闸机，有一个自助打印「入境小票」的机器，可以打印一张备用，我打印了但并没有用到。

如果是首次入境香港的话，香港那边的检查是不能走自助通道，必须走人工通道的，这点需要注意一下。

八达通

在西九龙出来的「九龙」地铁站的客服中心购买即可，只收港币现金，成人卡 150 港币，包括五十的押金和一百港币余额，这张卡基本在香港啥都能做，公交、地铁、零售店、麦当劳都可以用。八达通余额和押金是可以退的，我没退，想着下次可能还会去香港，如果想退的话，可以咨询地铁工作人员。

还有一个 65 港币的地铁 1 日票，可以连续 24 小时无限次搭乘地铁，不建议购买，因为如果只是办卡的话，可能地铁就一个来回，二十港币都花不到，完全是亏本的。

香港现在安不安全

招行香港只在工作日营业，我是周二去的，全程除了零星在地下通道或者过街天桥看到一些涂鸦、海报以外，一切都很平静，没有感觉到不安全的地方。大家都是自己走自己的，自己干自己的事情，给我的感觉还是非常安全的，而且走在大街上谁也不认识谁，没有太多需要担心的。

开户当天

怎么走？

先直接坐高铁到香港西九龙站，从西九龙站入境香港。高德地图在香港也是能用的，跟着地图导航走还是非常方便的。目的地设为「招商银行(香港分行)」，然后跟着导航步行至「九龙」地铁站，最难走的应该也就这段路了，因为弯弯绕绕的确实比较多。

如果地铁是坐到「香港」站 E2 出口出的话，那直接出了国际金融中心商场(IFC MALL)后，右边那栋楼就是。

如果和我一样是从「中环」地铁站 A 出口出的话，从 A 出口到地面，上电梯后沿天桥直走，到分叉位转左，经过交易广场第一及第二期后便到达交易广场三期，这边的提示牌很多，注意多抬头看看提示牌一般都不会走错的。

开户流程

电梯

我之前没用过这种电梯，还闹了个笑话——进了电梯以后发现里面怎么没有楼层按钮。原来是先需要在电梯外面的触摸面板上选择要去的楼层，然后上面会提示你到哪一部电梯(英文字母表示序号)，然后找到序号对应电梯等门开就行，会直接把你送到你所选的楼层的。招行香港分行在 28 楼。

取号

电梯到 28 楼开门就是招行香港，上前咨询大堂经理，我还没开口大堂经理就知道我是内地过来开户的。确认我把上文提到的五样东西都带齐了，就先让我看了一个类似”风险告知单”的东西，然后让我在招商银行手机 App 上在线填写开户申请表，如果你照我说的已经事先填好了开户申请，这时直接出示一下工作单位的天眼查或者企查查页面给大堂经理看一眼就可以取号了。取号后，大堂经理会告诉你，排在你前面的人数以及大概需要等待的时间。

需要等待的时间如果比较长，大堂经理会建议下去逛逛或者吃个饭啥的。下楼出门左转就是国际金融中心商场(IFC MALL)，去里面逛逛或者吃个中饭都是很不错的。

办理开户

我是上午十一点半取的号，大堂经理建议我是一点钟再过来，我担心过号，吃了个饭就又回来了。实际叫到我号是下午一点二十，等了快两个小时。

把身份证、港澳通行证、地址证明(只看第一页)、内地储蓄卡以及 Ukey 交给柜台工作人员，办理流程基本如下：

• 会让你再次出示天眼查或者企查查关于你工作单位的查询页面，主要是核对工作单位地址你自己填写的和 App 查询页面的是否一致
• 确认住宅地址是否准确有效
• 设置取款密码、查询密码。查询密码是打客服电话的时候需要输入的
• 确认开户用途，亲临香港开户的话，照实说开户目的是投资港股是没有问题的，投资港股的话会问你是哪家券商，照实说即可
• 其他大致就和内地银行开户差不多，会让你签几次字

整个柜台办理的过程很快，只花了十分钟就搞定了。

到手文件以及相关事项说明

柜台办理结束后，会给到你三份文件：「”香港一卡通”账户开户申请回单」、「”香港一卡通”使用提示」、「招商银行香港分行”香港一卡通”业务费率表」，三份文件都是繁体中文的。

• 「”香港一卡通”账户开户申请回单」

这是三份文件中最重要的一份，上面会有你的卡号、网上银行授权码(作用后面会提到)等相关信息，请务必保存好。这个授权码的有效期是三十天，所以务必及时关联绑定 Ukey。

• 「”香港一卡通”使用提示」

上面有关于怎么汇款、怎么绑定 Ukey、怎么激活卡片的说明，这些在官方公众号上也都能查到。

• 「招商银行香港分行”香港一卡通”业务费率表」

对各种业务收费的详细说明，柜员开户时也会和你强调上面写的「账户基本费」，也就是我们常说的账户管理费。这个费用是开户满三个月后才开始收取的，从第四个月开始，如果往前算三个月卡上日均资产低于五千港币，会收取每月一百港币的账户管理费，而高于五千港币则只收取十港币，所以尽量保证卡上日均资产在五千港币以上。

• 审批通过即可使用，无需实体卡到手

柜员特意强调了，只要收到审批通过的短信，这个账号就能够进行使用了，也就是说只要你收到了账号审批通过的短信，你进行网上汇款、转账、银证绑定都是可以的，当然在此之前你需要先绑定 Ukey 才能够使用网上银行对账户进行操作。实体卡只是方便你以后进行线下刷卡消费、ATM 存取款。

• 卡片绑定 Ukey 以及激活实体卡

柜员也嘱咐了收到短信以及卡片后，需要及时进行这两步操作，这些操作的指引在「”香港一卡通”使用提示」上都有，按照指引操作即可。

拿到这三份文件整个开户就结束了，可以回去等消息了。

审批时间

理论时间

柜员在办理开户的时候和我说的是需要一到二个工作日的时间进行审批，然后一个星期内寄出实体卡片。审批通过会有短信通知。

实际时间

我是当天下午一点半办理完开户，然后当天下午三点一刻就收到了卡片审核通过的短信。这个速度比我想象的要快多了，距我在柜台办完开户还不到两个小时。但我并不能确保这是正常速度，按照柜员的说法，最慢的话需要两个工作日。

后续工作

审批通过以后我们还有一些后续工作要做。

Ukey 绑定及验证手机号码

按照「”香港一卡通”使用提示」去招行香港官网下载「个人银行下载版」并安装，以后绝大部分操作都需要通过这个专业版网银进行操作，因为招行香港的手机 App 功能比较残缺。

招行香港 UKey 绑定激活时，如果 UKey 你之前已经在内地招商银行的专业版网银上激活过了，要先输 UKey 密码(内地网银专业版密码)，然后才会弹出窗口让你输 16 位授权码，这个授权码就是前面提到的「”香港一卡通”账户开户申请回单」上写的 16 位授权码，这个授权码的有效期是三十天，所以务必及时关联绑定 Ukey。

绑定完 Ukey 以后，在专业版上记得验证手机号码，这个我忘了我是在专业版上验证的还是在手机 App 上验证的了，还是很简单的，就不详述了。

绑定完 Ukey 以及验证完手机号码，这个账户就已经能够正常使用了，可以转账、银证转账。

收到实体卡及其激活

实体卡

我是在开户结束以后的第五天收到实体卡片的，我的卡片是从珠海发出的， EMS 配送。快递里面就是一个信封，信封里面装有实体卡片。

收到卡片后，需在 60 天内激活，否则卡片会作废，所以建议是收到卡当天就激活，以免忘记。要注意的是，实体卡有卡号那一面的左下角有一个内地银行卡没有的「卡片序号」，新卡的话都是「1」，这个在后面激活卡片时需要用到。

实体卡激活

激活有两种方式，一种是语音激活，这个在上面那张图有详细的操作指引，我选择的是网银激活。打开香港分行的专业版网银，登录以后，在「一卡通」->「其他功能」里面有「卡片激活」，按照提示激活即可，非常简单。

下图中的「凭证号」就是上文提到的「卡片序号」，激活页面下方也会有详细提示。

功能很少的招行香港 App

招行香港有自己独立的手机 App——「香港一卡通」，登录的时候直接用内地的招行一卡通的账号和密码登录，两者是相通的。可惜功能没相通啊，和内地功能完善的手机 App 比起来，「香港一卡通」App 完全就是个渣渣。全部功能见下图，就可怜巴巴地这么点。

稍微复杂的一点操作比如银证转账都需要在电脑上用「专业版网银」配合 Ukey 才能使用，如今大家都是一个 App 走天下，招行香港这一点必须要强烈吐槽，建议多向内地招行学习。

总结

1. 在内地准备好需要的五样东西：身份证、港澳通行证、内地招行储蓄卡、地址证明、Ukey

2. 在内地提前填写开户申请(非必选，到了香港再填也行)

3. 亲临香港柜台开户

4. 收到审批通过短信后的三十天内关联绑定 Ukey、验证手机号码

5. 收到实体卡后的六十天内激活实体卡片

真正办完以后回顾整个流程其实还算是比较简单的，门槛同样也是比较低，可能最大的门槛就是抽时间亲赴香港了吧。

前期的准备工作以及对很多信息的不了解也挡住了很多人，我花费时间最多的也是在前期各种资料的搜集上，这期间网上很多前辈写的文章对我也有不小的帮助，所以我也写了这篇文章分享出来，希望能够帮助到更多有办理招行香港银行卡需要的朋友。

了解最新情况

• 微信关注招行香港官方公众号「招商银行香港分行HongKong」，在里面开卡前、开卡后以及香港网点地址等常见问题都有解答，各种操作也都有相关指引。工作日上午九点到下午五点还有客服在线，直接在公众号内发送消息即可咨询。再强调一遍，所有信息以官方为准，官方的才是最准确有效的

• 联系招商银行客服电话 95555

联系我

如果您看完文章还有不明白的地方，或者发现我文章有错误的地方需要更正，抑或是有更多想问我的细节，都欢迎您

• 直接添加我的私人微信「AsuradaOvi」(烦请备注：招行香港开户)同我联系
• 直接在公众号「阿斯拉达」后台给我发消息同我联系

我看到后都会在空闲时间尽快给您答复或无偿向您提供力所能及的帮助。也欢迎您反馈关于办理流程、要求上最新的变动给我，我会及时更新到文章里面。

参考链接

香港一卡通开户指引及业务咨询

招行香港官网

开通招行香港一卡通的详细list

民生香港五十万港币资产要求

前情提要

这款炼狱蝰蛇 2013 是自己四年前买的，之前一直用得好好的，但最近滚轮的按键功能突然失效了，表现为能够正常按压，但无法正常触发按键功能。在日常浏览网页时，我习惯用中键来关闭标签页以及在新窗口打开链接，现在中键突然失灵了，对我的日常使用造成了很大的不便。

之前有在网上看过不少帖子都是自己修鼠标，感觉也不是很难，所以这次我也尝试一下来自己修鼠标。

所需工具

1.电烙铁
2.镊子
3.十字螺丝刀
4.新中键微动
5.焊锡丝
6.小刀

拆解鼠标

通过搜索在什么值得买上面找到了这篇维修教程，虽然文中问题是鼠标出现了双击的现象，和我的问题并不相同，但同样都是通过更换微动来解决问题，而且各个步骤都比较详细，给我提供了很大的帮助。

首先用刀片分别将鼠标背面左右上角的两个脚垫撬下来，两个脚垫是通过胶粘上去的，撬下来以后保存好，后面还原的时候还可以再粘回去。去掉两个脚垫后就可以看到里面的两颗螺丝了。这两颗螺丝可以直接拧下。

需要注意的是第三颗螺丝的位置，是隐藏在贴纸的下方，位置如下图所示，直接用螺丝刀捅破贴纸即可看到。这颗螺丝拧出一定距离即可，不必全部拧出。

三颗螺丝处理完毕后，从下图所示处往下掰，即可打开鼠标上盖，打开时小心不要用力过猛，因为上盖上有一根灯光线和主板相连，不小心的话可能会扯断。

断开上盖与主板的连线后，即可移走上盖，看到鼠标主板。接下来如下图所示依次卸下主板上的三颗固定螺丝、左侧按键微动上的两颗螺丝以及滚轮旁边的小黑色螺丝后，最后再断开两根排线，即可取下主板。注意保管好螺丝，特别那颗较小的黑色螺丝。

更换微动

观察主板可以看到滚轮横杆右侧的下方有一颗正方形微动，判断应该就是这个地方的微动损坏导致中键失灵。于是在万能的淘宝上花八毛钱+七块钱运费买了一个新的微动。

因为没有吸锡器，可以直接用电烙铁加热主板背面的焊点，然后边加热边拔也是可以把微动给卸下来的。

微动只是一个开关，不区分方向，将新微动针脚插入到主板对应孔位上，然后用电烙铁和焊锡对准针脚化开焊锡即可完成更换。如果卸旧微动的时候焊孔内还残留有焊锡也不用担心，直接加热焊孔，将焊锡加热到流动状，这时新微动针脚可以轻松穿过焊孔。

重装鼠标

按照刚刚的拆解步骤一步一步还原即可，排线全都有防呆设计，也不需要担心会接反。

最后自然是连接电脑进行测试，功能一切正常，又可以愉快地使用中键了。

总结

在有帖子可以参考的情况下，整个更换过程还是比较简单的，最大的困难可能是大部分同学没有电烙铁，专门为此添置一个可能显得有些本末倒置，毕竟电烙铁也不便宜。

自己动手，丰衣足食。人生第一次自己动手更换鼠标，成就感还是不小的。看到鼠标在自己手里满血复活，开心。

参考链接

“拿什么拯救你，我的双击蛇”— 手把手教你更换Razer炼狱蝰蛇鼠标微动

pqi 是国内开发者 yhf 开发的 PyQuickInstall 工具的简称，这款工具可以非常方便地帮助我们切换 pip 软件源，如果觉得好用的话，大家可以动动鼠标，在 Github 上面 Star 一下。

临时使用清华大学开源软件镜像源安装 pqi ：

1

pip install pqi -i https://pypi.tuna.tsinghua.edu.cn/simple

安装完成后，直接在命令行即可使用 pqi ：

1
2
3
4
5
6
7
8
9
10
11
12

//列举所有支持的PyPi源
pqi ls
//改变 PyPi源
pqi use <name>
//显示当前PyPi源
pqi show
//移除pip源
pqi remove <name>
//添加新的pip源
pqi add <name> <url>
//升级到最新版 pqi
pip install --upgrade pqi

如果决定使用上面提到过的清华大学镜像源，使用如下命令即可：

1

pqi use tuna

然后就可以享受飞一般的 pip下载速度了。

提交搜索引擎收录

博客搭建好了，如果希望自己博客的内容被更多人看到，搜索引擎所带来的流量是不容忽视的。为了让搜索引擎更快地收录我们的网站，我们可以主动到搜索引擎的站长平台提交我们的网站。

因为搜索引擎收录的内容比较多，所以专门单独写了一篇文章，具体内容请跳转 Hexo 博客主流搜索引擎收录详细指南查看。

站内搜索

此项配置基于 Hexo 5.1.1，Next 8.0.0，hexo-generator-searchdb V1.3.2

该功能由 hexo-generator-searchdb 提供，效果如下图：

在根目录下执行以下命令安装插件：

1

$ npm install hexo-generator-searchdb

在主题配置文件中修改相关字段：

1
2
3
4
5

local_search:
  enable: true
  trigger: auto # 每次输入改变都重新搜索
  top_n_per_article: 3 # 每篇文章显示的搜索结果数量
  unescape: false

在站点配置文件中添加以下字段：

1
2
3
4
5

search:
  path: search.xml # 后缀可选 .xml 和 .json
  field: post # 指定搜索范围，可选 post | page | all
  content: true # 是否牵引文章的全部内容，false 则只牵引文章标题
  format: html # 指定页面内容形式，可选 html | raw (Markdown) | striptags 

配置完成后，执行 hexo g 命令会在 public 文件夹下自动生成 search.xml 文件。

文末版权声明修改

版权声明添加标题

此项配置基于 Hexo 4.2，Next 7.8.0

Next 主题自带的版权声明默认只有作者、链接、版权声明三项，为方便他人转载，我觉得有必要加入文章标题的显示。

首先修改 .\themes\next\layout\_partials\post\post-copyright.swig 文件，在 <ul> </ul> 标签内根据自己的需求在相应位置新增以下代码：

1
2
3
4

<li class="post-copyright-title">
    <strong>{{ __('post.copyright.title') + __('symbol.colon') }} </strong>
    {{ post.title }}
  </li>

由于 post.copyright.title 是我们自己新增的，这一字段 Next 默认是没有对应的中文翻译的，所以我们需要通过修改 .\themes\next\languages\zh-CN.yml 文件来添加翻译，打开文件，搜索 copyright ，在下面新增 title: 本文标题 。

执行 hexo g 重新生成博客，hexo s 本地调试查看效果：

效果正是我想要的，确认无误后 hexo d 部署。

「本文链接」添加快速复制按钮

此项配置基于 Hexo 4.2，Next 7.8.0，本小节主要参考 yearito’s Blog | Hexo搭建个人博客系列：进阶设置篇

修改 .\themes\next\layout\_partials\post\post-copyright.swig 文件，改动如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

{%- set ccIcon = '<i class="fa fa-fw fa-creative-commons"></i>' %}
{%- set ccText = theme.creative_commons.license | upper %}


+<!-- JS库 clipboard 用来拷贝内容到粘贴板-->
+<script src="https://cdn.jsdelivr.net/npm/clipboard@2.0.6/dist/clipboard.min.js"></script>

+<!-- JS库 sweetalert 用来显示提示信息-->
+<script src="https://cdn.jsdelivr.net/npm/sweetalert@2.1.2/dist/sweetalert.min.js"></script>

<div>
<ul class="post-copyright">

  <!-- 本文标题 -->
  <li class="post-copyright-title">
    <strong>{{ __('post.copyright.title') + __('symbol.colon') }} </strong>
    {{ post.title }}
  </li>

  <!-- 本文作者 -->
  <li class="post-copyright-author">
    <strong>{{ __('post.copyright.author') + __('symbol.colon') }} </strong>
    {{- page.author or author }}
  </li>

  <!-- 引用链接 -->
  <li class="post-copyright-link">
    <strong>{{ __('post.copyright.link') + __('symbol.colon') }}</strong>
    {{ next_url(page.permalink, page.permalink, {title: page.title}) }}
+    <span class="copy-path" title="点击复制 Markdown 引用链接"
+      ><i
+        style="cursor: pointer"
+        class="fa fa-clipboard"
+        data-clipboard-text="[{{ post.author | default(author) }}'s Blog | {{ post.title }}]({{ post.permalink }})"
+        aria-label="{{ __('post.copyright.copy_success') }}"
+      ></i
+    ></span>
+  </li>
    
  <!-- 版权声明 -->
  <li class="post-copyright-license">
    <strong>{{ __('post.copyright.license_title') + __('symbol.colon') }} </strong>
    {{- __('post.copyright.license_content', next_url(ccURL, ccIcon + ccText)) }}
  </li>
</ul>

+ <script>
+   var clipboard = new ClipboardJS(".fa-clipboard");
+  clipboard.on("success", function(target) {
+    var message = document.createElement("div");
+    message.innerHTML =
+      '<i class="fa fa-check-circle message-icon"></i><span class="message-content">' +
+      target.trigger.getAttribute("aria-label") +
+      "</span>";
+    swal({
+      content: message,
+      className: "copy-success-message",
+      timer: 1000,
+      button: false
+    });
+  });
+ </script>

</div>

在版权样式文件 .themes\next\source\css\_common\components\post\post-copyright.styl 中新增如下样式：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

.swal-overlay {
  background-color: transparent;
}

.copy-success-message {
  box-shadow: 0px 4px 12px rgba(0, 0, 0, 0.15);
  border-radius: 4px;
  width: auto;
  margin: 16x 0px;
  vertical-align: middle;
}

.copy-success-message .swal-content {
  margin: 0px 0px !important;
  padding: 10px 16px;
  line-height: 1em;
}

.copy-success-message .message-icon {
  color: #52c41a;
  margin-right: 8px;
}

.copy-success-message .message-content {
  font-size: 14px;
}

然后补全版权信息文案字段：

1
2
3

post:
  copyright:
+   copy_success: 复制成功

之后点击「本文链接」后的图标便可以快捷复制 Markdown 格式的引用链接，并将弹出复制成功的提示语。

该功能主要借助 clipboard 和 sweetalert 两个 js 库来实现，并参考 antDesign | message 组件 重写了弹框样式。

修改文章 URL 地址

此项配置基于 Hexo 4.2，Next 7.8.0

Hexo 默认的文章 URL 地址为 https://yoursite.com/:year/:month/:day/:title/，层级较多，我自己看着碍眼，据说对 SEO 也不利。打开站点配置文件 _config.yml ，找到 permalink，将其改成自己想要的格式，我的很简单，全部的文章都是 post。

1
2
3
4
5
6
7

# URL
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
url: https://asurada.zone
root: /
-permalink: :year/:month/:day/:title/
+permalink: post/:title/
permalink_defaults:

生成 RSS 并在侧边栏添加 RSS 按钮

此项配置基于 Hexo 5.0，Next 7.8.0

安装 hexo-generator-feed 插件

在 Hexo 根目录执行命令，安装 hexo-generator-feed 插件：

1

npm install hexo-generator-feed --save

安装结束时后，此时重新 hexo g 便会直接在 Public 文件夹下自动生成 atom.xml文件。默认使用 atom 格式、输出全文、日期倒序排列，如果预设符合自己的要求，可以直接跳过下一步。

配置站点配置文件

在站点配置文件 _config.yml添加相关配置：

1
2
3
4
5

+# RSS
+feed:
+ type: atom
+ path: atom.xml
+ limit: false

配置含义：

1. type：RSS的类型，可选 atom/rss2，默认 atom
2. path：Feed 路径，默认 ./atom.xml 或 ./rss2.xml
3. limit: 展示文章的数量，使用 0 或 false 则输出所有文章

侧边栏添加 RSS 图标

Next 在V7.6.0中移除了侧边栏的 RSS 图标，后续又在V7.7.1中通过「Follow_me」功能将 RSS 图标引入到了文章的结尾区域。但我觉得 RSS 在整个网站的优先级应该足够高，下面是如何将 RSS 图标重新加入侧边栏的方法。

原理其实很简单，就是利用 Next 主题自带的 Social Links 功能，将 RSS 也变成一个 Social Link。修改主题配置文件 .\source\_data\next.yml 如下：

1
2
3
4

social:
  GitHub: https://github.com/ousugo || github
+ RSS: https://asurada.zone/atom.xml || rss
  #E-Mail: mailto:yourname@gmail.com || envelope

“Soical Links” 的格式为 Key: permalink || icon，其中 Key 为图标旁边显示的名称，permalink 为目标地址，这里指 RSS Feed 的地址，icon 为将要显示的图标在 Font Awesome 中的名字。

最终效果如下：

美化

文末添加结束标记

此项配置基于 Hexo 4.2，Next 7.8.0

感觉文章结束以后，紧接着就是打赏按钮，显得较为突兀，所以在文末添加结束标记，效果如下：

修改主题配置文件 .\source\_data\next.yml，取消 postBodyEnd 前的注释，启用 post-metabody-end.swig 这一自定义文件：

1
2
3
4
5
6
7
8
9

# Define custom file paths.
# Create your custom files in site directory `source/_data` and uncomment needed files below.
custom_file_path:
  #head: source/_data/head.swig
  #header: source/_data/header.swig
  #sidebar: source/_data/sidebar.swig
  #postMeta: source/_data/post-meta.swig
- #postBodyEnd: source/_data/post-metabody-end.swig
+ postBodyEnd: source/_data/post-metabody-end.swig

我们可以打开 .\themes\next\layout\_macro\post.swig 文件，搜索 next_inject，定位到 next_inject('postBodyEnd')：

这一段代码的含义就是当上面的 postBodyEnd 被取消注释时，post-metabody-end.swig 文件就会被插入到这里（望文生义，如理解有误请指出）。

在 .\source\_data 文件下新建 post-metabody-end.swig 文件，添加如下代码：

1
2
3
4
5
6
7

<div>
    <div style="text-align:center;color:#bfbfbf;font-size:16px;">
      <span>-------- 本文结束 </span>
      <i class="fa fa-paw"></i><!-- 这里的图标可以自己去 fontawesome.com 找，然后自定义 -->
      <span> 感谢阅读 --------</span>
    </div>
</div>

hexo s -g 预览效果没问题，就可以 hexo d 部署到博客了。

参考链接

yearito’s Blog | Hexo搭建个人博客系列：部署上线篇

小丁的个人博客 | Hexo-NexT 博客提交搜索引擎收录

yearito’s Blog | Hexo搭建个人博客系列：主题美化篇

yearito’s Blog | Hexo搭建个人博客系列：进阶设置篇

最近在准备六月份的 RT-Thread 的 RECA（RT-Thread开发者能力认证），官方组织了一个学习营，第一周的任务是：

基于 rt-thread4.0.2，能根据BSP制作教程及群里分享的视频《2.RTThread移植》，让自己的板子在RT-Thread上运行起来，了解BSP的制作。

本文并没有将 BSP 移植背后的原理全部弄清楚，只是想着先迈出第一步，不求甚解，先把整个流程给跑通。

我手上的开发板是正点原子的战舰 V3，所以我将基于 RT-Thread 官方的 STM32F1 系列 BSP 通用模板构建战舰 V3 的 BSP。

下载 RT-Thread 源码

从官网下载 RT-Thread 源码，我下载的版本是 V4.0.2。源码目录结构如下：

复制通用模板

制作新 BSP 的第一步是复制一份同系列的 BSP 模板作为基础，通过对 BSP 模板的修改来获得新 BSP。战舰 V3 采用的芯片是 STM32F103ZET6，所以我们需要使用 STM32F1 系列的模板。模板位于rt-thread\bsp\stm32\libraries\templates\stm32f10x，BSP 模板文件夹结构如下所示：

拷贝模板文件夹下的 stm32f10x 文件夹到rt-thread\bsp\stm32下，并将该文件夹的名称改为 stm32f1-my-diy，之后我们就在这个文件夹的基础上进行移植。

在接下来的 BSP 的制作过程中，将会修改 board 文件夹内的配置文件，将 F1 系列的 BSP 模板变成一个适用于正点原子战舰 V3 开发板的 BSP ，下表总结了 board 文件夹中需要修改的内容：

安装 CubeMX

下载 CubeMX

CubeMX 是基于 eclipse 的一个插件，用来对STM32产品的配置及初始化代码的生成。下载可以去 ST 中国站 –> 设计资源 –> 固件和软件 –> PC 端软件 –> STM32CubeMX

我下载的版本是 2020.04.21 更新的 V5.6.1。

在官网上下载要求先登陆账号，所以没有账号的同学需要先自行注册一个账号，中国站可以直接通过微信注册。

安装 CubeMX

前面已经说了 CubeMX 是基于 eclipse 的，所以它的运行需要依赖 Java 运行环境，后续具体的步骤可以参考STM32CubeMX系列教程02_STM32CubeMX工具、HAL库下载、安装说明，写得非常详细。

使用 CubeMX 配置工程

模板文件内已经有 CubeMX 工程了，位于stm32f1-my-diy\board\CubeMX_Config下，双击打开 CubeMX_Config.ioc 工程。

配置芯片

我使用的是正点原子战舰 V3 的开发板，使用的 CPU 是 STM32F103ZET6，CubeMX 模板工程使用的并不是这个芯片，所以我需要重新配置芯片为「STM32F103ZETx」。

启用系统时钟

紧接着配置系统时钟，启用高速外部时钟(HSE)和低速外部时钟(LSE)：

打开串口外设

Connectivity –> USART1 –> Mode:Asynchronous，将 USART1 配置为异步模式。

注意这里只需要选择串口外设引脚即可，无需配置其他参数。这里配置串口是为了后续使用 RT-Thread 的 FinSH 组件。

配置完成后，我们可以把右边的芯片图放大，然后就能看到芯片右侧的 PA10、PA9 引脚变成了绿色，后面还跟了当前引脚的功能，其中 PA10 引脚是 UASRT1 的接收引脚，PA9 是 UASRT1 的发送引脚。

设置调试方式

System Core –> SYS –> Debug:Serial Wire，将调试配置 SWD 模式，这种模式一个最大的优点就是占用的 IO 口较少，我们从右侧的芯片图可以看到 SWD 模式只使用了两个 IO 口 PA13 和 PA14。

时钟配置

HSE 是高速外部时钟，可接石英/陶瓷谐振器，或者接外部时钟源，频率范围为 4MHz~16MHz。战舰 V3 开发板接的是 8M 的晶振。

LSE 是低速外部时钟，接频率为 32.768kHz 的石英晶体。 这个主要是 RTC 的时钟源。

根据正点原子《STMF1 开发指南》，这一步进行的时钟配置为：

• 启用 HSE 作为 PLL 时钟源
• 设置 PLL 9 倍倍频
• 选择系统时钟源为 PLL
• 设置 APB1 分频系数为 2

最后总结一下配置过后关键时钟频率值：

1
2
3
4
5

SYSCLK(系统时钟)    =72MHz
PLL 主时钟 =72MHz
AHB 总线时钟（HCLK=SYSCLK/1）   =72MHz
APB1 总线时钟（PCLK1=HCLK/2）   =36MHz
APB2 总线时钟（PCLK2=HCLK/1）   =72MHz

生成 CubeMX 项目

最后生成的时候，因为我们复制过来的模板工程里面本来就有 CubeMX 项目，选择直接覆盖即可。

拷贝时钟初始化函数

在 board/board.c 文件中存放了函数 SystemClock_Config() ，该函数负责初始化系统时钟。当使用 CubeMX 工具对系统时钟重新配置的时候，需要更新这个函数。

该函数由 CubeMX 工具生成，默认存放在board/CubeMX_Config/Src/main.c 文件中。但是该文件并没有被包含到我们的工程中，因此需要将这个函数从 main.c 中拷贝到 board/board.c 文件中。该函数内容如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

/**
  * @brief System Clock Configuration
  * @retval None
  */
void SystemClock_Config(void)
{
  RCC_OscInitTypeDef RCC_OscInitStruct = {0};
  RCC_ClkInitTypeDef RCC_ClkInitStruct = {0};

  /** Initializes the CPU, AHB and APB busses clocks 
  */
  RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE;//时钟源为 HSE
  RCC_OscInitStruct.HSEState = RCC_HSE_ON;//打开 HSE
  RCC_OscInitStruct.HSEPredivValue = RCC_HSE_PREDIV_DIV1;//HSE 预分频
  RCC_OscInitStruct.HSIState = RCC_HSI_ON;//打开 HSI
  RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;//打开 PLL
  RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE;//PLL 时钟源选择 HSE
  RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL9;//设置 PLL 倍频系数
  if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK)
  {
    Error_Handler();
  }
  /** Initializes the CPU, AHB and APB busses clocks 
  */
  RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK
                              |RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2;
  RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;//设置系统时钟时钟源为 PLL
  RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1;//AHB 分频系数为1
  RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV2;//APB1 分频系数为2
  RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1;//APB2 分频系数为1

  if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_2) != HAL_OK)
  {
    Error_Handler();
  }
}

修改 board.h

在 board.h 文件中配置了 FLASH 和 RAM 的相关参数，这个文件中需要修改的是 STM32_FLASH_SIZE 和 STM32_SRAM_SIZE 这两个宏控制的参数。

战舰 V3 所使用的 STM32F103ZET6 芯片的 FLASH 大小为 512K，RAM 的大小为 64K，因此对该文件作出如下的修改：

修改 Kconfig 选项

在本小节中修改 board/Kconfig 文件的内容有如下两点：

• 芯片型号和系列
• BSP 上的外设支持选项

芯片型号和系列的修改如下表所示：

关于 BSP 上的外设支持选项，一个初次提交的 BSP 仅仅需要支持 GPIO 驱动和串口驱动即可，因此在配置选项中只需保留这两个驱动配置项，如下图所示：

修改工程构建相关文件

接下来需要修改用于构建工程相关的文件。

修改链接脚本

linker_scripts 链接文件如下图所示：

其中 MDK 使用的链接脚本是 link.sct ，其他两个链接脚本的文件分别为 IAR 使用的 link.icf 和 GCC 编译器使用的 link.lds。我使用的是 MDK，所以修改 link.sct 文件。

战舰 V3 使用的芯片为 STM32F103ZE，FLASH 为 512K，因此修改 LR_IROM1 和 ER_IROM1 的参数为 0x00080000（512 * 1024）。RAM 的大小为 64K， 因此修改 RW_IRAM1 的参数为 0x00010000（64 * 1024）。

修改 SConscript 构建脚本

SConscript 脚本决定 MDK/IAR 工程的生成以及编译过程中要添加文件。

在这一步中需要修改芯片型号以及芯片启动文件的地址，战舰 V3 使用的芯片是 STM32F103ZET6，所以使用的启动文件是 startup_stm32f103xe.s，对应的芯片型号是 STM32F103xE。最后修改内容如下图所示：

修改 MDK 工程模板

template 文件是生成 MDK/IAR 工程的模板文件，通过修改该文件可以设置工程中使用的芯片型号以及下载方式。MDK4/MDK5/IAR 的工程模板文件，如下图所示：

我使用的 MDK5，所以我修改的模板是 template.uvprojx 文件。

• 战舰 V3 所使用的的芯片型号为 STM32F103ZET6，所以修改芯片型号如下：

• 修改程序下载方式：

修改完成后记得 Ctrl+S保存。

安装 ENV 工具

Env 工具简介

Env 是 RT-Thread 推出的开发辅助工具，针对基于 RT-Thread 操作系统的项目工程，提供编译构建环境、图形化系统配置及软件包管理功能。

其内置的 menuconfig 提供了简单易用的配置剪裁工具，可对内核、组件和软件包进行自由裁剪，使系统以搭积木的方式进行构建。

Env 工具包含了 RT-Thread 源代码开发编译环境和软件包管理系统。

下载安装 Env 工具

• 从 RT-Thread 官网下载 Env 工具，将其解压到任一纯英文路径下即可使用，在 Env 目录下有一张 Add_Env_To_Right-click_Menu.png(添加 Env 至右键菜单.png) 的图片，按照图片指引一步步操作，就可以在任意文件夹下通过右键菜单来启动 Env 控制台，效果如下：

• 在电脑上装好 git，软件包管理功能需要 git 的支持。git 的下载地址为https://git-scm.com/downloads，根据向导正确安装 git，并将 git 添加到系统环境变量。

• 注意在工作环境中，所有的路径都不可以有中文字符或者空格。

重新生成 MDK 工程

重新生成 rtconfig.h 文件

在 env 界面输入命令 menuconfig 对工程进行配置。

menuconfig 快捷键介绍

修改配置

menuconfig 有多种类型的配置项，修改方法也有所不同，常见类型如下：

• 开/关 型：使用空格键来选中或者关闭
• 数值、字符串型：按下回车键后会出现对话框，在对话框中对配置项进行修改

我们目前的目的仅仅是移植 BSP，所以先不进行复杂的配置，只使能 GPIO 和 UART：

• Hardware Drivers Config –> On-chip Peripheral Drivers –> 使能「Enable GPIO」和「Enable UART」
• 「Enable UART」 –> 「Enable UART1 RX DMA」

保存配置

选择好配置项之后按 ESC 键退出，选择保存修改即可自动更新 rtconfig.h 文件。此时再次使用 scons 命令就会根据新的 rtconfig.h 文件重新编译工程了。

重新生成 MDK5 工程

使用 env 工具输入命令 scons --target=mdk5 重新生成工程，如下图所示：

重新生成工程成功：

生成新的 MDK5 工程以后，我们可以看到 project.uvprojx 的修改日期已经变成刚刚进行生成操作时的日期了。

验证 MDK5 工程

双击打开 project.uvprojx，检查后发现在我们没有进行设置的情况下，此工程芯片型号、默认下载设置都和我们之前对模板工程的修改保持一致，说明我们之前的修改是生效了的。

我们通过左边的项目框架里可以看到，相比模板工程的空空如也，新工程已经是五脏俱全了。打开 Applications --> main.c，内容很简单，在 main 主函数内只有一个让 LED0 闪烁的程序，直接编译，没有任何错误和警告。为了方便调试和及时查看运行结果，设置程序下载结束后自动重启并运行：

连上战舰 V3 开发板，直接烧录程序，会发现 LED 并没有亮起来，检查代码后会发现，程序默认定义的 LED0 是引脚 PB.1，通过而查看战舰开发板的原理图，发现战舰开发板的 LED0 连接的是 PB.5 引脚，将引脚进行更改后编译，再烧入程序，LED0 正常闪烁。

后记

至此，我们的 BSP 移植就算成功了。但回顾整个移植过程，发现自己不明白的地方还太多了，特别是如何由模板工程直接构建出一个能够直接运行的工程，在没有了解其中原理之前，这个过程对我这个菜鸟而言无异于「魔法」；我开始移植的基础是 RT-Thread 内置的 STM32F1 系列通用模板，这个模板我是拿过来就用的，但这个模板是如何一步步构建起来的，我也完全没有弄清楚；CubeMX 图形化的操作方式固然对新手非常友好，但无疑也让我对底层代码的理解隔了一层「黑盒」。

第一步已经迈出去了，希望通过后面的学习能够解答我上面诸多疑惑，学习不就正是这样一个发现问题，解决问题的过程。

参考链接

RT-Thread 官方 STM32 系列 BSP 制作教程