分类目录归档：Programming

如何写好 Git 提交记录

发表评论

英文原文：How to Write a Git Commit Message

前言：为什么要写好提交记录

如果你随便挑一个 Git 仓库去查看它的提交日志，你可能会发现这些日志通常或多或少都是混乱的。我们可以来看看早些年间我在 Spring 项目中的提交记录:

$ git log --oneline -5 --author cbeams --before "Fri Mar 26 2009"

e5f4b49 Re-adding ConfigurationPostProcessorTests after its brief removal in r814. @Ignore-ing the testCglibClassesAreLoadedJustInTimeForEnhancement() method as it turns out this was one of the culprits in the recent build breakage. The classloader hacking causes subtle downstream effects, breaking unrelated tests. The test method is still useful, but should only be run on a manual basis to ensure CGLIB is not prematurely classloaded, and should not be run as part of the automated build.
2db0f12 fixed two build-breaking issues: + reverted ClassMetadataReadingVisitor to revision 794 + eliminated ConfigurationPostProcessorTests until further investigation determines why it causes downstream tests to fail (such as the seemingly unrelated ClassPathXmlApplicationContextTests)
147709f Tweaks to package-info.java files
22b25e0 Consolidated Util and MutableAnnotationUtils classes into existing AsmUtils
7f96f57 polishing

嗯哼，我们再来跟这个仓库中近期的一些提交记录做个对比：

$ git log --oneline -5 --author pwebb --before "Sat Aug 30 2014"

5ba3db6 Fix failing CompositePropertySourceTests
84564a0 Rework @PropertySource early parsing logic
e142fd1 Add tests for ImportSelector meta-data
887815f Update docbook dependency and generate epub
ac8326d Polish mockito usage

看了这两段提交记录，你更倾向于看到哪个？

前者的记录中，文本的长度和格式都比较随意，而后者的文本长度和格式就都比较统一了。前者的格式纯属自然形成，而后者的格式就不是偶然形成的了。

虽然大部分仓库的日志看起来都更像前者，但 Linux kernel 和 Git 自己 就是两个很好的例外。我们还可以看看 Sprint Boot 项目 或者是由 Tim Pope 管理的任何一个仓库。

👆上面提到的这些仓库的参与者们都很清楚编写一个良好的 Git 记录是用来与其他开发者（也许是他未来的自己）交流和沟通某次修改的上下文内容的最优方式。一次简单的 diff 操作是能告诉你改动了什么，但是只有提交记录才能准确地告诉你为什么要这么改。 Peter Hutterer 很好地指出了这一点：

重建一段代码的上下文是非常费时间的。我们无法完全避免它，所以我们应该尽可能地减少需要重建代码上下文的可能性。提交记录刚好就能帮我们做到这一点，从一个提交记录完全可以看出这个开发者是否能够很好地跟其他人进行协作。

如果你还没有怎么想过一个良好的 Git 提交记录为什么更好，可能是你还没有在类似于git log的这些工具上花太多的时间。这里有个恶性循环：由于提交历史的结构毫无组织并且格式也不一致，所以就没人愿意花时间去利用和管理它。因为这些提交历史从来也没有人会去利用和管理它，所以它的结构就一直毫无组织，格式也就一直这么不一致下去了。

但是一个管理良好的提交日志是一个既漂亮又有用的东西。有了它之后，git blame，revert，rebase，log，shortlog和一些其他的子命令就焕发生机了。这样一来 review 别人提交的代码和 pull request 变得顺理成章了，而且还能独立地进行。如此一来，通过提交记录来搞清楚几个月前乃至几年前都发生了什么不只是变成可能的了，而且还更高效了。

一个项目的长期成功取决于（尤其是）它的可维护性，而一个项目的维护者最有力的工具就是项目的提交日志了。所以花时间去学习如何管理好这些提交日志就显得很很值当，也很有必要了。刚刚开始的时候，大家可能或多或少都会对此有所争论和意见，但是一旦形成了习惯之后，这会让整个项目的参与者都倍感自豪和效率倍增的。

在这篇文章中我只注重于保持一个健康的提交历史所需的最基本要素：如何写好一个独立的提交记录。还有很多其他重要的实践技巧，例如 “commit squashing”(压缩提交记录)等，在这篇文章中我不会展开讨论。也许后续我会单独再写一篇文章来讨论一下。

大多数编程语言中都有一些已经形成的良好约定来保持风格的一致性，例如：命名规则，代码格式等等。当然这种类似的约定有着各种各样不同的版本，但是，我想大部分的开发者都会同意选择其中一种并坚持使用这一种约定，远比大家各自为政搞得混乱不堪要好上千千万万。

一个团队里头大家的代码提交日志的方式方法应该保持一致。为了使得代码库的修改日志变得有用，团队中的所有成员应该就编写提交记录的方式方法达成一个约定，这个约定需要确定这三个要素：

风格，语法、换行、排版、大小写、标点符号，把这些能确定下来的规则都确定下来，别让大家去猜到底要怎么做，尽可能地把规则简单化确定化。最终的结果将是一个风格非常一致的日志，到时候大家不只是愿意去看这些日志了，甚至会时不时地主动去读这些日志了。

内容，提交记录的正文中应该写什么内容呢（如果需要的话）？又有哪些提交记录需要正文呢？

元数据，如何在提交记录中引用 Bug 跟踪号、pull requset 编号等？

幸运的是对于如何编写一个惯用的提交记录已经有了一些既定的约定。事实上，它们中的许多都是可以通过 Git 的命令行功能来达成的。你不需要重新创造任何轮子，只需要遵守以下7条规则，你就可以像一个高手一样编写好你的提交记录了。

一条优秀的 Git 提交记录的 7 条规则

记住：这 都 已 被 多次 强调过。

  1. 使用空行将提交记录的标题和正文分开
  2. 限制标题字符数在50以内
  3. 标题首字母大写
  4. 标题行末不使用句号
  5. 在标题中使用祈使句
  6. 限制单行字符长度最大为72
  7. 在正文中详细解释说明这次提交的改动

举个例子：

Summarize changes in around 50 characters or less

More detailed explanatory text, if necessary. Wrap it to about 72
characters or so. In some contexts, the first line is treated as the
subject of the commit and the rest of the text as the body. The
blank line separating the summary from the body is critical (unless
you omit the body entirely); various tools like `log`, `shortlog`
and `rebase` can get confused if you run the two together.

Explain the problem that this commit is solving. Focus on why you
are making this change as opposed to how (the code explains that).
Are there side effects or other unintuitive consequences of this
change? Here's the place to explain them.

Further paragraphs come after blank lines.

 - Bullet points are okay, too

 - Typically a hyphen or asterisk is used for the bullet, preceded
   by a single space, with blank lines in between, but conventions
   vary here

If you use an issue tracker, put references to them at the bottom,
like this:

Resolves: #123
See also: #456, #789

1. 使用空行将提交记录的标题和正文分开

从 git commit 命令的手册中我们可以看到：

Though not required, it’s a good idea to begin the commit message with a single short (less than 50 character) line summarizing the change, followed by a blank line and then a more thorough description. The text up to the first blank line in a commit message is treated as the commit title, and that title is used throughout Git. For example, Git-format-patch(1) turns a commit into email, and it uses the title on the Subject line and the rest of the commit in the body.

翻译一下：

虽然这不是必须的，但是我们认为在提交记录的最前面使用50个字符以内的文本来概括一下本次提交的改动是一个很好的主意，然后紧随其后使用一个空行，再接着写更为详细的正文描述。从第一个字符到第一个空行之间的文本内容会被当作提交记录的标题， Git 在各个模块上都是这么处理的。例如： Git-format-patch(1) 会将一个提交记录转换为一封电子邮件，这个时候提交记录的标题就会被当作邮件的标题，而提交记录中其余的内容会被当作邮件的正文。

当然我们需要先说明一点，不是所有的提交记录都一定需要一个标题和正文。有的时候一句话就够了，特别是当某个提交记录就是非常简单的时候，压根儿就不需要再多写什么。例如：

Fix typo in introduction to user guide

就这么一句简洁的描述就够了，如果看到这条提交记录的人想知道修改的究竟是哪个拼写错误，他/她只需要通过 git show 或者 git diff 再或者 git log -p 把修改内容显示出来，简单地扫一眼就能知道具体修改了哪个拼写错误了。

如果你在提交的时候只需要编写这种简单的内容的化，你可以直接在命令行中，简单地在 git commit 命令后面加一个 -m 选项，然后跟上需要填写的提交记录内容即可：

 $ git commit -m "Fix typo in introduction to user guide"

不过当一个提交需要解释一下修改的上下文时，你就需要编写提交记录的正文了。例如：

 Derezz the master control program

MCP turned out to be evil and had become intent on world domination.
This commit throws Tron's disc into MCP (causing its deresolution)
and turns it back into a chess game.

这种带有正文和标题的提交记录就不太好直接在命令行中通过 -m 选项添加了。这个时候你最好是在一个趁手的文本编辑器中编写你的提交记录。如果你还没有设置好 Git 在命令行中调用的文本编辑器的话，可以参考这篇文章。

总之不论怎样，分开提交记录中的标题和正文对于我们日后再次浏览提交日志是大有裨益的。下面是一个查看提交日志全文的输出：

$ git log
commit 42e769bdf4894310333942ffc5a15151222a87be
Author: Kevin Flynn <[email protected]>
Date:   Fri Jan 01 00:00:00 1982 -0200

 Derezz the master control program

 MCP turned out to be evil and had become intent on world domination.
 This commit throws Tron's disc into MCP (causing its deresolution)
 and turns it back into a chess game.

现在我们再用 git log --oneline 输出一下，此时 Git 只会输出提交记录中的标题：

$ git log --oneline
42e769 Derezz the master control program

或者我们再来看看 git shortlog，这个命令会将提交记录按照提交者进行分组，为了显示的简洁，Git 也只会输出提交记录的标题。

$ git shortlog
Kevin Flynn (1):
      Derezz the master control program

Alan Bradley (1):
      Introduce security program "Tron"

Ed Dillinger (3):
      Rename chess program to "MCP"
      Modify chess program
      Upgrade chess program

Walter Gibbs (1):
      Introduce protoype chess program

在 Git 中还有很多其他的应用场景也会区分提交记录的标题和正文，但是如果没有标题和正文之间的那个空行的话，这些应用场景就都白扯了。

2. 限制标题字符数在50以内

50 个字符并不是一个硬性的限制，只是一个经验法则罢了。将标题行限制在这个长度首先可以确认它的可读性较好，同时也会强制提交者去主动思考是否可以用更简洁的话来解释究竟发生了什么。

小帖士：如果你发现你很难去概括你的某次提交记录，那么很有可能就是你这次提交了太多的修改了。这个时候你需要尽可能地做到实现提交原子化(这是一篇单独讲提交原子化的文章)。

GitHub 的 UI 交互设计就完全遵守了这些约定。如果你提交的记录中标题的文本长度超过 50 个字符，它就会警告你超出了 50 个字符的限制。

标题字符过长的警告

而且它会将标题中长度超过 72 之后的所有字符截断，并用省略号来代替显示。

截断并使用省略号

所以尽可能争取将标题长度控制在 50 以内，实在不行的话也不要超过 72。

3. 标题首字母大写

这一条就是这么简单。确保每个标题的首字母大写就好了。例如，这样：

  • Accelerate to 88 miles per hour

而不是这样：

  • accelerate to 88 miles per hour

4. 标题行末不使用句号

标题行末的句号是不需要的。另外在标题行中尽量谨慎使用空格，当你想要控制标题长度在 50 以内的话，一个空格都显得尤为珍贵啊。

我们可以这样：

  • Open the pod bay doors

但是不要这样：

  • Open the pod bay doors.

5. 在标题中使用祈使句

祈使句的意思就是“像发号施令一样地说或写”。例如：

  • 打扫房间
  • 关门
  • 倒垃圾

你现在正在读的这7条规则就是用的祈使句（“限制单行字符长度最大为72”等）。

祈使句听上去感觉有点粗鲁，但这也是我们平时不怎么用到它的原因。但是这正好符合 Git 提交记录标题的需求。其中一个主要的原因就是 Git 自己在我们每次执行一次提交的时候都在使用它。

例如我们使用 git merge 命令进行合并时，自动生成的提交记录是这样的：

Merge branch 'myfeature'

还有 git revert 生成的提交记录是这样的：

Revert "Add the thing with the stuff"

This reverts commit cc87791524aedd593cff5a74532befe7ab69ce9d.

或者当我们在 GitHub 中点击 “Merge” 按钮之后，生成的提交记录是这样的：

Merge pull request #123 from someuser/somebranch

所以当你使用祈使句来编写你的提交记录时，其实你就是在遵循 Git 内建的约定。例如：

  • Refactor subsystem X for readability
  • Update getting started documentation
  • Remove deprecated methods
  • Release version 1.0.0

刚刚开始这么写提交记录的时候是感觉有点诡异。因为我们更习惯于使用陈述句来陈述具体的事实。这也是为什么通常的提交记录长得这样：

  • Fixed bug with Y
  • Changing behavior of X

有的时候提交日志又写得很像是对提交内容的描述：

  • More fixes for broken stuff
  • Sweet new API methods

为了防止大家搞混而不知道到底应该怎么写，这里有一个屡试不爽的公式可以简单地套用。

一个格式良好的 Git 提交记录的标题应该永远可以直接放在这句话的最后面：

  • 如果应用了这个提交，就会 你的提交记录的标题

例如下面这些例子中的标题就是 OK 的：

  • 如果应用了这个提交，就会 重构 X 子系统的可读性 (refactor subsystem X for readability)
  • 如果应用了这个提交，就会 更新新手入门指南文档 (update getting started documentation)
  • 如果应用了这个提交，就会 删除废弃的方法 (remove deprecated methods)
  • 如果应用了这个提交，就会 发布1.0.0版本 (release version 1.0.0)
  • 如果应用了这个提交，就会 合并某个用户/分支的#123号pull request (merge pull request #123 from user/branch)

而下面这些非祈使句语气的标题就不太好使了：

  • 如果应用了这个提交，就会 使用了Y修复了Bug (fixed bug with Y)
  • 如果应用了这个提交，就会 修改X的行为 (changing behavior of X) （好吧，我承认这个我不知道要怎么翻译了。）
  • 如果应用了这个提交，就会 针对错误更深入的修复 (more fixes for broken stuff)
  • 如果应用了这个提交，就会 牛逼的新方法 (sweet new API methods)

记住：我们只是需要在提交记录的标题中使用祈使句。在写提交记录的正文时，就完全可以随意一些了。

6. 限制单行字符长度最大为 72

Git 自己从来都不会主动换行的。当你在写提交日志的时候，你必须注意日志文本的右边距，然后适时地手动换行。

推荐是每行达到 72 个字符就换行，这样的话 Git 在需要控制整行文本内容在 80 字符内的同时，还能有足够的空间来进行格式的缩进。

这个时候我们就需要一个趁手的编辑器。在 Vim 中很容易就能通过配置，让其在我们写 Git 提交记录的时候每到 72 个字符就自动换行。然而通常 IDE 在对提交记录自动换行的支持上都非常的糟糕（虽然 IntelliJ IDEA 在最近的版本中已经对此做了一些的改进）。

7. 在正文中详细解释说明这次提交的改动

这个比特币官方仓库中的提交记录就是一个很好的示范，它很好的解释了此次提交修改了什么以及为什么要做出这个修改：

commit eb0b56b19017ab5c16c745e6da39c53126924ed6
Author: Pieter Wuille <[email protected]>
Date:   Fri Aug 1 22:57:55 2014 +0200

   Simplify serialize.h's exception handling

   Remove the 'state' and 'exceptmask' from serialize.h's stream
   implementations, as well as related methods.

   As exceptmask always included 'failbit', and setstate was always
   called with bits = failbit, all it did was immediately raise an
   exception. Get rid of those variables, and replace the setstate
   with direct exception throwing (which also removes some dead
   code).

   As a result, good() is never reached after a failure (there are
   only 2 calls, one of which is in tests), and can just be replaced
   by !eof().

   fail(), clear(n) and exceptions() are just never called. Delete
   them.

我们可以对照这次提交的完整 diff来看一下，想象一下作者在这个提交中把本次提交的修改的上下文环境做了如此清楚的说明后，给项目的其他伙伴们以及后续其他的参与者们节省了多少的时间。如果他没有这么做的话，恐怕大家每次都得在这儿浪费时间了。

大多数情况下，我们可以不需要在提交记录中详细地说明我们是怎么做的修改。因为通常代码自己就能将实现的方法表达清楚了（如果这个代码的逻辑确实复杂到没法通过代码自己解释清楚的话，那么这个时候我们就需要在代码里头写注释了）。所以我们在提交记录的正文中，首先要先将为什么要做这次修改的原因说清楚，说清楚在此之前是怎么实现的（以及那么实现有什么问题），然后说明现在是怎么实现的，以及你为什么选择了现在的这种方法来实现的原因。

相信我，后续的维护者都会感谢你的，当然更有可能的是你会感谢你自己。

小帖士

学会使用命令行，忘掉 IDE 吧

鉴于 Git 有太多的子命令可用，我觉得拥抱命令行是明智之选。Git 简直牛逼到炸，当然 IDE 们也很牛逼，只不过它们各自牛逼的地方不太一样。我每天都在使用 IDE（IntelliJ IDEA），而且也曾广泛地使用过其他的 IDE（Eclipse），但是我还从来没有见过哪个 IDE 能将 Git 的功能集成到牛逼如其原生的命令行（一旦你掌握了）。

当然有些 Git 的方法被 IDE 们集成得很棒，例如在删除文件的时候主动调用git rm命令，在我们重命名某个文件的时候，会调用一系列的 Git 命令来实现文件在 Git 仓库中的重命名。但是当你开始使用 IDE 进行 commit, merge, rebase 或者是做些复杂的提交历史分析的时候，IDE 就不行了。

如果你想发挥 Git 的全部潜能，那么命令行是首选。

记住，无论你是在使用 Bash、Zsh 或是 Powershell，都可以通过 Tab 键自动补全脚本来帮助我们更好地记住各种子命令和开关。

好好读读 《Pro Git》 这本书

《Pro Git》 这本书非常棒，而且可以在线免费阅读，好好利用吧，亲！

【翻译】关于 Unicode 和字符集，每个程序员都必须掌握的基本内容（别找借口！）

发表评论

关于 Unicode 和字符集，每个程序员都必须掌握的基本内容（别找借口！）

原文链接在这里：The Absolute Minimum Every Software Developer Absolutely, Positively Must Know About Unicode and Character Sets (No Excuses!)

你是否曾好奇过 ”Content-Type“ 这个 tag 究竟是用来干嘛的？就是那个你在编写 HTML 的时候必须设置的 tag，你是不是一直压根都不知道这货是用来干嘛的呢？

你是否也曾收到过你那儿来自保加利亚的朋友发给你的邮件，但是杯具的是邮件标题显示成 “???? ?????? ??? ???” 这样的乱码了呢？

令我失望的远不止于此，我发现非常多的软件开发人员（程序员）对于字符集、编码和 Unicode 这一类的东西毫无了解。几年前，一个 FogBUGZ 的 beta 测试用户曾经问过我们 FogBUGZ 是否可以支持接收日文的邮件。啥，日文？你们还用日文写邮件啊？好意外啊，我怎么知道能不能支持。然后当我开始认真地去研究我们用来解析邮件消息的 MIME 的商业版 ActiveX 控件时，我们发现这货在处理字符集的这件事上彻头彻尾的错了，所以我们必须自己编写代码来避免它做出错误的转换，并且确保解析正确。然后，我又研究了一下另一个商业的类库，好吧，这货的字符处理模块也彻头彻尾的错了。我联系了这个类库的开发者，并跟他沟通了一下这个问题，你猜人家肿么说的，“对此我们无能为力”。就像大部分程序员一般，估计他希望这个问题能随风远去吧。

然而并不会，有木有。当我发现世界上最好的编程语言 PHP 竟然无视字符集的存在，非常牛逼地直接使用 1 个字节（8 位）来保存字符，这使得 PHP 几乎不可能直接用来开发良好的国际化 Web 应用程序（这不是我说的，是 Joel 说的哦）。好吧，也许够用就好了。

所以，在此我要声明一下：如果你是一个 2003 年的程序员，然后你告诉我你对于字符、字符集、编码和 Unicode，那么别让我逮着你，否则我会把你关到核潜艇上去剥 6 个月的洋葱的（尼玛捡肥皂是不是更好）。相信我，我是认真的。

另外，我想说的是：

这并不难。

在这篇文章里，我会尽量将每个程序员在实际工作中都需要掌握的基本内容讲清楚。尼玛那些 “plain text = ascii = characters are 8 bits” 这种鬼画符的东西不止是错了，简直错到姥姥家去了，如果你继续这么写代码的话，那你就跟一个不相信细菌存在的医生差不多了。请你在读完这篇文章之前，别再写任何代码了。

在我开始之前，我需要先说明一点，如果你对于国际化已经很熟悉了话，你会发现整篇文章讨论的内容相对来说会有点过于简单了。我确实只是尝试着设定一个最低标准来进行讨论，以便每个人都能理解到底发生了什么，并且能学会如何编写可以支持除英语之外的语言显示的代码。另外，我需要说明的一点是，字符处理只是软件国际化工作中的很小的一部分，不过今天在这篇文章里头我一次也就只能讲清楚这一个问题。

历史回顾

理解这些东西最简单直接的方法就是按时间顺序来回顾一遍。

你也许觉得我要开始讲一些类似于 EBCDIC 之类的远古时代的字符集了。然而，我就不。EBCDIC 跟你已经没有半毛钱关系了。我们没必要再回到那么远古的时代了。

那么我们回到中古时代吧，当 Unix 刚刚发明出来时，K&R（Brian Kernighan 和 Dennis Ritchie）还在写《The C Programming Language》 这本书的时候，一切都是那么的简单。EBCDIC 就是那个时候出现的。在 EBCDIC 中只考虑到了那些不带音调的英文字母，我们称其为 ASCII，并且使用 32 到 127 之间的整数来代表所有的字符。空格是 32，字母 “A” 是 65，以此类推。这些字母使用 7 位就可以很容易地保存了。不过那个时代的大部分电脑都使用的是 8 位架构，所以不止可以很容易地保存所有的 ASCII 字符，我们还有 1 位富余出来可以用来存别的东西，如果你比较邪恶的话，你完全可以拿这 1 位来偷偷地干坏事：WordStar 这款软件就曾经使用 8 位中的最高位来标记字母是否是一个单词中的最后一个，当然 WordStar 也就只能支持英文文本了。小于 32 的字符被称为不可打印字符，主要用于符咒（开个玩笑罢了）。这些字符是用作控制字符，例如 7 对应的这个字符就是让你的电脑哔哔哔地响，12 这个字符就是让打印机吐出当前正在打印的纸张，接着吸入下一张新的纸张。

ASCII

这一切看上去都还是挺美好的，如果你是一个只说英语的人。

由于这一个字节共 8 位，可以表达的数字是 0 ～ 255，那么就还有可利用的空间，很多人就开始想“对啊，我们可以利用 128 ～ 255 来达成我们自己的一些想法”。可问题的关键是，想到这个点子的人实在是太多了，而且就这 128 ～ 255 之间的数字，他们的想法还各不相同。IBM-PC 的开发人员把这部分设计成了一个提供了部分带有音调适合欧洲语言的字符和一组划线符号的 OEM 字符集，这组划线符号有横杆、竖杠、右边带有虚点的横杠等等，有了这些划线符号，你可以在屏幕上画出非常整齐的方形图案，你现在依然可以在你家的干洗机自带的 8088 微机上看到这些图案呢。事实上一旦当美国之外的人们开始购买 PC，那么各种不同语言的 OEM 字符集纷纷涌现出来，这些字符集们都各自使用这 128 个高位字符来达成自己的设计目的。例如，有些 PC 机上字符编码为 130 的字符是 é，但是在那些以色列出售的机器上，它是希伯来语中的第三个字符(ג)，所以当美国人给以色列人发送 résumés 时，在以色列人的电脑上收到之后会显示为 rגsumגs。还有很多类似的例子，例如俄罗斯人，他们对于如何使用这 128 个高位字符编码有着太多太多不同的想法了，所以你压根就没法可靠地通过某种既定的规则来转换俄语的文档。

OEM

最终这场 OEM 字符集的混战由 ANSI 标准终结了。在 ANSI 标准中，低于 128 编码的字符得到了统一，跟 ASCII 码完全一致，但是对于高于 128 编码的的字符，就有很多种不同的方法来处理了，这主要取决于你住在哪儿。这些不同的高位字符处理系统被称为码点页。例如，以色列 DOS 系统使用了一个名为 862 的码点页，希腊人用的是 737 码点页。这两个系统中，字符编码低于 128 的字符都是一样的，但是高于 128 编码的字符就不同了，所有其他有趣的字母就都放在这儿了。全国的 MS-DOS 版本得有几十个这样的码点页，用来处理从英语到冰岛语，甚至还有部分多语言的码点页用来处理世界语和加利西亚语在同一台电脑上的显示。哇！但是希伯来语和希腊语还是无法在一台电脑上同时显示，除非你自己编写一个程序将所有的字符都按照位图来显示，因为处理希伯来语和希腊语的高位编码的字符所需要的码点页完全不同。

同时在亚洲，这件事情显得尤为严重，因为亚洲语言文字有成千上万的单字，8 位根本无法表达这么多的单字。这个问题通过一个叫做 DBCS（double byte character set） 的系统解决了，在这个系统里头有些单字使用 1 个字节来表示和存储，有些单字使用 2 个字节。这个系统有个问题就是，它可以很容易地实现字符串中往前查找单字，但是几乎没法往后查找。程序员们不应该 s++ 和 s– 这样的操作来往后和往前查找单字，而应该调用类似于 Windows 系统中提供的 AnsiNext 和 AnsiPrev 函数来完成相应的操作，这些函数会自行搞定那些乱七八糟的事情。

但是就是还有那么多的人，他们依然假装 1 个字节就是一个字符，一个字符就是 8 位，而且你也从来不会把一个字符串从这台电脑发送到另一台电脑上，也只会一种语言，这样的话，貌似是没什么问题的。当然，事实上是互联网出现了，字符串在不同电脑之间的传输变得既平常又频繁，这下这些乱七八糟的字符处理系统终于扛不住了。幸运的是我们有了 Unicode。

Unicode

Unicode 很成功地将目前地球上所有的文字书写方式都整合到了一个字符集里头，甚至一些虚构的文字都可以囊括进来，例如克林贡语等等。有些人可能简单地误以为 Unicode 就是一个简单的 16 位的编码，每个字符都是用 16 位来进行存储和表示，那么它就最多能表示 65536 个字符了。实际上这样理解是不对的。这是对于 Unicode 最常见的一种误解，你这么想并不孤独，别在意就好了。

实际上 Unicode 对于字符的管理有一套完全不同的思维方式，你必须理解 Unicode 的思维方式才行。

现在，让我们假设需要将一个字母转换为二进制数据存储到磁盘或内存中：

A -> 0100 0001

在 Unicode 中，一个字母映射一个码点，这个码点是一个理论上的常量值。至于这个码点如何存储到内存或磁盘就完全是另外一回事了。

在 Unicode 中，字母 A 是一个纯抽象的概念，它并不指向任何特定的字符表示形式。抽象的 A 和 B 不是同一个字符，A 和 a 也不是同一个字符，但是 A 和 A 还有 A 指的却是同一个字符。也就是说在 Times New Roman 字体中的 A 和 在 Helvetica 字体中的 A 是同一个字符，但是与同一个字体中的小写的 “a” 却是不同的字符，看上去好像也没啥毛病对吧，但是在有些语言里头这就行不通。例如德语中的 ß 字母究竟是一个独立的字母呢，还是 “ss” 的一个花俏的写法？如果一个字母出现在单词的末尾，它的形状就要发生变形，那么它们要算是不同的字符吗？希伯来语就是这样的，但是阿拉伯语又不是这样的。不过不管怎样，Unicode 组织中那些牛逼的大大们在过去的十年里已经帮我们把这些问题都解决了，天知道他们都经历过了什么样的争辩与妥协（这已经是政治问题了，亲），所以你不需要再去担心这些问题了。他们已经把这些问题都搞定了。

每一个字母表中的抽象的字母都会被 Unicode 组织分配到一个长这样的魔数：U+0639。这个魔数被称为码点。“U+” 代表这个字符采用的是 Unicode 编码并且采用十六进制来表示编码的值。U+0639 对应的是阿拉伯字符中的 ع 。而英文字母的 A 对应的 Unicode 码点是 U+0041。你可以通过 Windows 2000/XP 中自带的 charmap 工具或者访问 Unicode 的官网来查找不同字符的码点或者通过码点进行反向查找。

Unicode 编码所能定义的字符数量是不存在上限的，实际上 Unicode 字符集中定义的字符数量早已经超出 65536 了，所以并非所有的 Unicode 字符能被压缩为两个字节进行存储，但是这听上去有点诡异对吧。

好吧，那么我们来看个字符串：

Hello

在 Unicode 编码中，对应该字符串的 5 个字符的码点值为：

U+0048 U+0065 U+006C U+006C U+006F

至此我们看到的都只是一串码点值，看上去实际上都只是数字而已。我们还没有讨论过如何将这些字符如何存储到内存或者在 Email 中如何显示它们。

编码

想解释上面的两个问题，就需要涉及到编码了。

最早的 Unicode 编码试图将所有的字符都编码为两个字节来存储，那么好的，我们只需要将这些数字编码为两个字节，然后按顺序排好。那么 Hello 就成这样了：

00 48 00 65 00 6C 00 6C 00 6F

就这样吗？等等，我们看看这样行吗？

48 00 65 00 6C 00 6C 00 6F 00

从技术上来说，这两种编码方式都是可以的，事实上早期的 Unicode 编码实现者们就希望能以大端字节序或者小端字节序的方式来存储他们的 Unicode 码点，无论他们的电脑的 CPU 是快还是慢，现在是白天还是晚上，反正现在就是有了两种存储 Unicode 码点的方式了。所以人们就必须在处理 Unicode 字符串之前，遵守一个奇怪的约定，那就是在每一个 Unicode 字符串的最前面加上 FE FF 这两个字节（这被称为 Unicode 字节顺序标记，也被戏称为 BOM，炸弹的谐音）用来标记这个 Unicode 字符串的编码字节序是大端字节序，如果使用小端字节序进行编码存储的话，就在 Unicode 字符串编码的最前面加上 FF FE 两个字节，这样一来解析该 Unicode 字符串的人，在读取整个字符串编码的最前面两个字节就能判断当前的 Unicode 字符串究竟是采用大端字节序进行编码存储还是使用的小端字节序。但是，你懂的，真实的情况是，并非所有的 Unicode 字符串都会在其最头部加入所谓的 BOM 噢。

这看上去都挺好的，可是过了没多久，就有一帮程序猿开始有意见了。他们说：“靠，你们看看这些 0 们，你们有什么想法没有！”。因为他们是美国人，而且他们看到的也大都是英文，所以他们几乎从来都不回用到高于 U+00FF 的码点。另外他们还是加州的自由主义嬉皮士，他们很想节约一点存储空间（呵呵）。如果他们是德州人，他们就压根不会在意这多出来一倍字节数。但是加州的这帮弱鸡们就是无法忍受要把存储字符串的的空间給增大一倍，并且他们已经有了那么多的该死的文档已经是使用 ANSI 和 DBCS 字符集进行编码和存储的，尼玛谁愿意再一一地去給这些文档做格式转换啊？光是出于这个原因，很多人在很长的一段时间里头都选择无视 Unicode 的存在，与此同时，事情变得越来越糟了。

于是机智的 UTF-8 登场了。UTF-8 是另一个用来编码存储 Unicode 字符码点的编码方式，使用 8 个比特来存储码点魔数种的每一个数字。在 UTF-8 中，码点从 0 到 127 的字符都是使用一个字节来进行存储。只有码点值为 128 以及更高的字符才会使用 2 个或者 3 个字节进行存储，最多的需要使用 6 个字节。

UTF-8

这个方案有个巧妙的附带效果，那就是对于英文来说，在 UTF-8 和 ASCII 中的编码几乎是一模一样的，所以美国人根本都意识不到有任何问题。只有世界上其他地区的人才需要去跳过这些坑。还以这个 Hello 为例，它的 Unicode 码点是 U+0048 U+0065 U+006C U+006C U+006F，在 UTF-8 编码中将会以 48 65 6C 6C 6F 的形式来存储。看，这就跟使用 ASCII 和 ANSI 编码进行存储一毛一样了对伐。好了，现在如果你执意要使用带有音调的字母或者是希腊字母和克林贡字母的话，那么你就需要使用多个字节来保存一个字母的码点了，但是美国人压根儿都意识不到。（UTF-8 还有一个优良的特性，就是那些无知的使用一个值为 0 的字节来作为字符串终止符的老旧字符串处理代码不会错误地把字符串給截断了）

目前为止，我已经告诉了你有三种 Unicode 字符的编码方式。最传统的做法是将所有的字符编码保存到两个字节中，这种编码方法被称为 UCS-2（因为存储在两个字节里头）或者 UTF-16（因为使用了 16 个比特），而且你需要根据字符串的 BOM 来判断其存储采用的是大端字节序还是小端字节序。更为普遍被采用的就是新的 UTF-8 编码标准了，使用 UTF-8 编码有个好处，就是对于那种无脑的只能处理 ASCII 字符陈年老程序或者碰巧你只需要处理英文文本的话，你几乎不用做任何调整就可以正常使用了。

当然实际上还有很多种不同的 Unicode 字符编码方式。例如 UTF-7 就是一种跟 UTF-8 非常相似的编码方式，但是它会确保一个字节中的 8 个比特中最高位的值永远为 0，所以如果你必须通过某种认为只需要使用 7 个比特来进行字符编码就够了的政府-警察的电子邮件系统来发送 Unicode 字符的话，UTF-7 就能将 Unicode 字符压缩到 7 位并进行编码和存储，而不至于丢失字符串中的任何内容。还有 UCS-4，它将每个 Unicode 字符的码点编码为 4 个字节进行存储，它的优势是所有的字符都是使用相同的字节数进行存储，不过，这样的话，即便是德州人估计都不太乐意浪费这么多的内存空间了。

现在你在想的应该是，理论上来讲，所有这些通过 Unicode 码点来表示的字符，应该也能通过原来的老的编码方式来进行编码才对啊。例如，你可以讲 Hello（U+0048 U+0065 U+006C U+006C U+006F）的 Unicode 字符串通过 ASCII 编码的方式进行编码，也可以通过老的 OEM Greek，甚至是 Hebrew ANSI 编码方式，乃至前面我们提到的几百种编码方式。但是使用这些老的编码方式对 Unicode 字符进行编码都会有同一个问题：那就是有些字符是无法正常显示的。如果在这个编码方式中找不到一个跟 Unicode 字符的码点对应的字符来显示，你通常都只能看到一个问号 ？，或者更好一些的就是一个带着黑色的块中有个问号 �。

有好几百种这种过时的编码系统，只能正确地存储一小部分的 Unicode 字符码点，然后将其他的字符都存储的存储为问号 ？了。例如一些非常常用的英文文本编码方式 Windows-1252（Windows 9x 中内置的西欧语言的标准编码方式）和 ISO-8859-1 也叫做 Latin-1（也适用于所有西欧语言），都没法正确地存储俄文字符或者希伯来语字符，而只会把这些字符变成一串串的问号 ？。而 UTF 7，8，16 和 32 就都能很好地将任何码点的字符进行正确的编码和存储。

关于编码的一个最重要的事实

如果你已经完全忘掉了我刚刚吧啦吧啦讲了的一大堆东西，那么就记住一个非常重要的事情，那就是“如果不知道一个字符串使用的是什么编码，那么你就完全不知道它会是个什么鬼”。你再也不能像鸵鸟一般把头埋到沙子里头，然后假装所有的纯文本都是使用 ASCII 编码的。

根本就没有什么纯文本这样的东西。

如果你有一个字符串，不论它是在内存里，在文件中，还是在一封电子邮件里头，你都需要知道它的编码方式，否则你压根就没法正确地解析它，然后再正确地显示给你的用户。

几乎所有类似“我的网站看起来尼玛彻底乱码了啊”以及“她没法查看我发的带有音调字母的电子邮件”这种傻逼问题，通常都是因为某个无知（naive）的程序猿压根儿都没理解一个很简单的道理，那就是如果你不告诉我你的字符串使用的是 UTF-8 或者 ASCII 还是 ISO-8859-1（Latin 1），又或是 Windows 1252（西欧语言）编码，你压根儿就没法正常地显示这些字符，甚至都没法判断字符串在那儿结束的。高于 127 的码点字符的编码方式有好几百种，这就彻底歇菜了。

那么我们如何将字符串使用的编码信息保存起来呢？当然，这也都有标准的方法来实现。例如在电子邮件中，你就需要在邮件内容的头部加入一段这种格式的文本来说明这封电子邮件正文使用的编码方式：

Content-Type: text/plain; charset=”UTF-8″

对于网页来讲，最开始的想法是这样的，Web 服务器在每次返回网页内容的同时会返回一个类似的 Content-Type 的 HTTP 的头信息，注意不是在网页 HTML 文件中，而是在服务器返回 HTML 文件之前通过一个 HTTP 的响应头返回的。

不过这样就带了一些问题。假设你有一个庞大的 Web 服务器，这个服务器上部署了很多的网站，而且这些网站的网页是由很多使用不同语言的人创建的，而他们都直接使用微软的 FrontPage 编写网页，然后直接将 FrontPage 生成的网页文件拷贝到服务器上。服务器没法真正地确定每个网页文件实际上使用的编码方式的，所以它就没法正确地发送 Content-Type 的 HTTP 头了。

如果你能使用某种特殊的 tag 将 HTML 文件的 Content-Type 在网页文件内进行正确地声明，那么也是挺方便的。但是这就让那些纯粹主义者们就疯了，在你知道一个 HTML 文件的编码之前，你要怎么读取这个 HTML 文件来解析它内部的内容呢？（听起来有点鸡生蛋，蛋生鸡的意思噢）不过幸运的是，几乎所有常用的编码对于码点值 32 到 127 之间的字符处理都是一样的，所以你总是可以直接解析 HTML 文件中的关于编码的 tag 的内容，而不需要关注可能出现的乱码的字符，通常 HTML 文件中关于编码的 tag 的内容如下：

<html>
<head>
<meta http-equiv=“Content-Type” content=“text/html; charset=utf-8”>

我们需要注意的是这个 meta tag 必须是 <head> 标签中的第一个子节点，因为浏览器在读取到这个 meta tag 之后就会马上停止继续解析当前的网页内容了，而是使用 meta tag 中声明的编码重新开始解析当前网页的内容。

那么如果浏览器没有从 HTML 文件和 Web 服务器返回的 HTTP 头中读取到任何指定当前网页的 Content-Type 的信息，浏览器会怎么解析当前网页呢？ IE 浏览器实际上会做一些很有意思的事情：它会基于不同的字节在不同语言中的常用编码和出现频率，尝试着去猜测当前网页使用的语言和编码方式。由于不同的老的 8 位码点页编码系统总是尝试着将其国家或地区语言中特殊字符映射到 128 到 255 之间的不同点位，而每种语言中的字符实际上是有其统计上的特征的，所以 IE 浏览器的这个自动判断当前网页使用的语言和编码方式偶尔还是能奏效的。乍看上去非常诡异，但是由于总是有些无知的网页开发者压根儿就不知道需要在他们编写的网页的头部声明网页的 Content-Type 以便浏览器能正确地展示他编写的网页。直到有一天，他们编写了一个不符合他们母语字符分布规律的网页，而 IE 浏览器最终会把这个网页当成韩文来进行渲染展示，坦率地讲我认为波斯特尔法则（Postel’s Law）—— “严于律己，宽于待人”（哈哈，这个翻译有点诡异，实际上的意思是，对于自己创建和发送的内容要尽量严格要求，减少出错的可能，而对于我们接收的内容要尽可能的宽容，并考虑容错）并不是一个好的工程准则。不管怎么说，这个网站可怜的读者们面对这原本应该显示为保加利亚语的网页被显示为韩语（还不确定是北朝鲜语或者是南朝鲜语），他又能做什么呢？他可以使用 IE 浏览器中菜单栏里头的视图（View）|编码（Encoding）选项来尝试使用不同的编码方式（大概有个几十种东欧的语言吧）来显示当前网页，直到他最终试出了当前网页使用的语言和编码。当然前提是他得知道这么操作才行，然而实际上绝大部分人根本就知道怎么调整浏览器渲染和显示网页时使用的编码。

在我们公司发布的最新版本的网站管理软件 CityDesk 中，我们决定在软件内部实现中都采用 UCS-2 编码，这也是 Visual Basic、COM 和 Windows NT／2000/XP 底层使用的字符串编码方式。在 C++ 中，我们将所有的字符串都声明为 wchar_t（宽字符） 类型，而不再使用 char 类型，使用 wcs 方法，而不再使用 str 方法（同理我们会使用 wcscat 和 wcslen 替换 strcat 和 strlen 方法）。在 C 语言中，你只需要在字符串的前面加上一个大写的 L，例如 L“Hello” 就可以创建一个字面上的 UCS-2 字符串了。

在 CityDesk 发布网页时，它会将所有的网页都转化为 UTF-8 编码，多年以前各大浏览器对 UTF-8 编码的支持就已经非常好了。这也是为什么 Joel on Software 这个网站拥有 29 种语言的版本，但是我从来没有听说过任何一位读者反馈说他没法正常地浏览这个网站上的内容。

这边文章写得实在是太长了，但是我依然无法在这一篇文章里涵盖字符编码和 Unicode 的所有内容，但是我依然希望当你读完这篇文章，再回去编程的时候，能不再盲信什么水蛭或咒语可以治病，而是学会如何正确地使用抗生素，这是是我想留给你的一个小任务。

使用 Supervisor 自制开机自启动后台服务

2条回复

使用 Supervisor 自制开机自启动后台服务

写在前面的废话

这几天在了解了一些关于 kcptun 相关的信息（耀华同学科普的），想着近期自己的 VPS 科学上网方案时不时的抽风，就上手折腾了一番。但是作为一个仅仅会照着官方文档执行一些命令的我，对于很多 Linux 服务器运维相关的知识知之甚少，原来因为身边总是有耀华同学，搞不定直接把问题丢给他就好了，可是现在更多的时候得靠自己了。

然后找到耀华同学了解了一番如何在 Linux 服务器上自制一个开机自启动服务，最终选择了耀华同学推荐的 Supervisor。废话到这，下面开始折腾。

安装 Supervisor 服务

在做一件自己以前从未做过的事情之前，建议大家还是自备一个不会影响到其他人和自己的虚拟机进行学习和测试，相信我，你总有可能做出一些自己难以预测而破坏性又大的事情的。记住，不要因为自己的无知，影响到他人和自己，否则你会因为这个后果自己承担不起或者恼怒不已，最终你会把锅扣在你正要开始学习的事物上，这对于我们开始一项新的学习无疑毫无益处。

我们歌王同学刚好今天在公司内网新建了一台全新的 CentOS 的虚拟机，我刚走过去想问问能否给我一台仅供我自己折腾使用的服务器，歌王就把用户名和密码给我了，简直贴心到爆啊，有木有，有这样的同事，也是我修来的福分好伐。

其实我想要的最好是一台 Ubuntu 服务器啦，毕竟讲真，对于我这样的菜鸟服务器管理员，Ubuntu 总感觉可用度更高些（各种问题 Google 一下，马上出来），大部分流行的工具在官方的软件库里头都能找到，确实能省不少的事情，降低了维护的难度和成本。不过看了一眼 Supervisor 官方文档，感觉这货在各大 Linux 的发行版上都如鱼得水呢，毕竟它是用 Python2 实现的嘛，那么 CentOS 就 CentOS 吧，我总不能再要求我们歌王同学再给我去搞一个 Ubuntu 的虚拟机吧（我们公司后端使用的服务器均是 CentOS）。

通过 easy_install 直接安装 Supervisor，执行以下命令：

easy_install supervisor

即可安装 Supervisor，安装成功之后，可以执行以下 supervisord，测试一下是否安装成功，确认安装成功之后，我们就可以继续下一步了，编写开机自启动后台服务的配置。

编写开机自启动后台服务的 Supervisor 配置

编辑 /etc/supervisord.conf 文件（如果没有的话，执行 echo_supervisord_conf > /etc/supervisord.conf 创建该配置文件），在文件末尾新增以下配置：

[program:ss-proxy-kcptun-sg]
command=/root/kcptun/client_linux_amd64 -c /root/kcptun/ss-kcptun-config-sg.json

就是这么简单，Supervisor 默认的选项已经完全够用了，重新执行命令 supervisord -c /etc/supervisord.conf，然后我们就可以通过命令 ps aux | grep kcptun 来确认 kcptun 的 client 是否已经随着 supervisord 的启动自动启动了。

配置 Supervisor 开机自启动

通过上面的步骤，我们已经可以让 kcptun 的 client 随着 supervisord 的启动自动启动了，但是 supervisord 的开机自启动还得做一下设置（由于我这里是通过 easy_install 来安装的，貌似这货不会自启动），也许使用 yum 直接安装 Supervisor 会自动启动噢。我在 Ubuntu 上使用 apt 安装的 Supervisor 确实是会自动启动的（而且其默认的配置文件在 /etc/supervisor/supervisord.conf 这里噢）。

至于如何在不同的系统下设置 Supervisor 的开机自启动，在 Supervisor 的官方文档上有这么一句噢:

If you are using a distribution-packaged version of Supervisor, it should already be integrated into the service management infrastructure of your distribution.

There are user-contributed scripts for various operating systems at: https://github.com/Supervisor/initscripts

There are some answers at Serverfault in case you get stuck: How to automatically start supervisord on Linux (Ubuntu)

我现在的操作系统是 CentOS，所以我就从这个 Supervisor 的官方 Github 账号下的一个用户们分享的启动脚本的仓库中，下载了适用于 CentOS 的启动脚本，从文件的命名以及脚本内容的风格来看，这货是一个用于 systemd 启动的配置呢。

所以我就 Google 了一番，关于如何在 CentOS 上创建 systemd 的启动脚本，这里有完整的在 CentOS（实际上是 Redhat 啦，不过我们都晓得 CentOS 师出 Redhat 门下，同根同源，不会错的） 上创建一个自定义的 systemd 的启动脚本的流程。以下是我执行的所有脚本的流程：

curl https://raw.githubusercontent.com/Supervisor/initscripts/master/centos-systemd-etcs > supervisord.service
mv supervisord.service /etc/systemd/system
chmod 644 /etc/systemd/system/supervisord.service
systemctl daemon-reload
systemctl start supervisord.service

此后如果修改了 Supervisor 使用到的相关配置，需要重启 Supervisor 服务的话，执行 systemctl restart supervisord.service 即可。

Linode 上 VPS 重启后 MySQL 服务器挂了的恢复方法

2条回复

做个备忘，省得每次遇见都得重新 Google 了。

这次 Linode 整体更新 XEN 的安全漏洞补丁之后，我的 VPS 重启之后，自己也没有注意，今天打开一下自己的博客站点，发现 WordPress 报了了一个「连接数据库出错」的问题，首页无法正常打开了。

之前也碰到过类似的问题，但是之前每次都是直接丢给我们可爱的耀华同学来搞定的，现在耀华同学不在身边，有的时候用起来就没有那么顺手了，所以捏，咱们还是得学会自己动手，丰衣足食啊。在询问了耀华同学咱们 MySQL 的错误日志在哪里无果之后，本想尝试直接使用耀华同学提供的通过 find 命令暴力查找了（事实证明这样可能可以找到，但是会比较麻烦），刚好看到网上有个默认地址提供了，直接 cd 到那个目录之后，看到一个长得很像的 error log 文件，打开一看，果了个然啊。打开看看错误日志里头的错误是啥，原来是 mysql 依赖的临时文件创建不成功，文件权限有问题，那么修改一下文件权限吧，修改好了文件权限之后，重启 mysql 服务，一切 OK。

那么我们来回顾一下整个流程是怎么样的。

  1. 发现 WordPress 报告 MySQL 数据库连接出错了，那么 ssh 到 VPS 上，执行一下 ps aux | grep mysql 命令，发现并没有 mysql 服务进程，可以肯定 mysql 服务没有成功启动；
  2. 那么接下来我们就要看看 mysql 服务为啥没有在此次 XEN 补丁升级后自动启动成功呢，找 error 日志来看吧，最终我们发现 rpm 默认安装的 mysql 错误日志路径在 /var/lib/mysql 目录下，跟 mysql 的核心数据库文件就在同一个目录，建议不要这么干，还是在 my.cnf 中好好地配置一下 mysql 的日志文件存放路径吧（由于我并非一个合格的服务器开发人员或维护人员，原谅我使用了默认配置）；
  3. 找到这个名称为 li402-16.err（文件名格式为：[host-name].err） 的错误日志文件，滚到最下面一行，看看错误是啥吧，/usr/libexec/mysqld: Can’t create/write to file ‘/dev/shm/ibinQuSV’ (Errcode: 13)；
  4. 这下可以确认是因为不能往 /dev/shm 这个目录里头写入文件了，如果不是磁盘满了那么肯定就是权限不足，所以无法写入文件，但是这个目录其实是一个内存里头的临时文件目录，所以不会出现满了的情况，那么肯定的权限的问题；
  5. 接下来我们就应该给 mysql 用户分配 /dev/shm 目录的写权限就好了，由于我比较懒（实际上是不太会，这个会有安全隐患的），我直接把 /dev/shm 的权限修改为 777 了，建议还是自行严格地将写入权限分配给 mysql 用户吧；
  6. 然后通过 /etc/init.d/mysqld start 启动 mysql 服务；
  7. 再次打开博客站点首页，测试通过，OK 搞定了。

此事的原因很有可能是因为 VPS 重启之后，对于某些敏感文件目录，XEN 容器管理的原则就是将其恢复到默认的文件权限吧，不是很了解，但是直觉会是这样，也就是说以后碰到重启这样的情况再次出现 MySQL 启动错误，都应该先检查一下是否为临时文件写入权限的问题导致的。

喵的，这次 Linode VPS 硬件问题之后，机器再次重启了，泥煤的啊，突然发现，在这里的备忘压根达不到备忘的效果啊，VPS 挂了，博客打不开啊，你上哪儿看去呢？好像是个问题呢。

用Python写一个简单的Alfred Workflow用于颜色值的转换

发表评论

由于自己是程序员，而且比较痴迷于使用各种工具，虽然可能这些工具并没有给我的效率带来太大的提高，但是我就是喜欢折腾这些软件，因为能给我带来快乐和满足感，你说谁不想爽呢。

Alfred是我使用Mac之后安装的第二个工具软件（正常工作需要的开发软件和浏览器之类的通用软件不算），第一个是Dash，第二个是Alfred。Dash是在试用了5分钟不到，查看Android帮助文档如飞的响应速度，让我直接购买了正版授权。Alfred是在当做Launch软件使用了快1年之后，看了很多人提到的关于Workflow的增强功能之后，在某个非常想购物的日子里头买了一个PowerPack，从此用上了Workflow的功能，当然在这一年里头实际上我也就只用了有道词典这么一个Workflow，其他的几乎不怎么使用，主要还是习惯问题。

这几天手痒，总觉得自己不像个能折腾的程序员，刚好看到一个用于转化数字的Workflow感觉还不错，试用了一下之后，我发现其实我自己也有一个比较强的需求可以通过这个Workflow来完成。在做Unity3D的开发过程中，我们时常会需要使用到调色板来给界面上的文字进行着色，就是设置颜色值。但是美术一般提供过来的就是效果图，或者是RGB值，通常格式是这样的(234,120,54)，但是在实际的开发中我们并不是每次都是针对一个UILabel（我们的UI使用NGUI开发）进行字体颜色设置，因为有的时候我们只是想突出显示一段文字中的某一部分，这个时候依赖于NGUI UILabel的BBCode机制，我们可以通过 [ffbbcc]需要指定颜色显示的文字内容[-] 这样的方式来实现同一个UILabel下的文字使用不同的颜色进行显示。

那么这个时候有一个能快速转换（234,120,54）为#ea7836就有一些必要了，参考那个Number Convertor我就自己开始造轮子了。

Alfred Workflow设置页面

找到Number Convertor这个Workflow，选中任意一个Script Filter右键，弹出菜单之后点击Configure，或者直接双击也行，然后弹出一个配置页面，配置页面的右下方有一个Open workflow folder的按钮，点击之后会打开当前Workflow对应的所在目录，然后我们会发现这个目录下面有以下的内容：

Alfred Workflow对应目录

仔细查看一下，我们会发现所有的转化逻辑都是通过number_convertor.py文件来完成的，但是这个脚本依赖于一个叫Workflow的Python库，这个目录里头的workflow就是干这个用的。这个Python的库可以在这里找到。

以下是的脚本内容：

# -*- coding: utf-8 -*-
import sys
from workflow import Workflow

def main(wf):
    cmd = wf.args[0]
    input_str = wf.args[1]

    values_str = ""
    if cmd == "2rgb":
        values_str = conver_hex_to_rgb(input_str)
        desc = u'将%s转化为RGB格式' % (input_str)
    elif cmd == "2hex":
        values_str = convert_rgb_to_hex(input_str)
        desc = u'将%s转化为HEX格式' % (input_str)
    wf.add_item(title=values_str, subtitle=desc, arg=values_str, valid=True)
    wf.send_feedback()

def ignore_exception(IgnoreException=Exception,DefaultVal=None):
    """ Decorator for ignoring exception from a function
    e.g.   @ignore_exception(DivideByZero)
    e.g.2. ignore_exception(DivideByZero)(Divide)(2/0)
    """
    def dec(function):
        def _dec(*args, **kwargs):
            try:
                return function(*args, **kwargs)
            except IgnoreException:
                return DefaultVal
        return _dec
    return dec

sint = ignore_exception(ValueError,0)(int)


def convert_decimal_to_hex(numstr):
    decimal_var = sint(numstr)
    return "{0:#0{1}x}".format(decimal_var,4)[2:]

def convert_rgb_to_hex(rgb_str):
    if rgb_str.startswith("(") and rgb_str.endswith(")"):
        splits = rgb_str.strip("()").split(",")
        if (len(splits) == 3):
            red_decimal_str = splits[0]
            red_hex = convert_decimal_to_hex(red_decimal_str)
            green_decimal_str = splits[1]
            green_hex = convert_decimal_to_hex(green_decimal_str)
            blue_decimal_str = splits[2]
            blue_hex = convert_decimal_to_hex(blue_decimal_str)
            hex_str = "#" + red_hex + green_hex + blue_hex
            return hex_str
    	else:
    		return ""
    else:
        return ""

def conver_hex_to_rgb(hex_str):
	if hex_str.startswith("#"):
		hex_str = hex_str[1:]
        if len(hex_str) == 6:
            red_decimal_var = sint(hex_str[0:2],16)
            green_decimal_var = sint(hex_str[2:4],16)
            blue_decimal_var = sint(hex_str[4:6],16)
            return "(%d,%d,%d)" % (red_decimal_var, green_decimal_var, blue_decimal_var)
        elif len(hex_str) == 3:
            red_decimal_var = sint(hex_str[0:1] + hex_str[0:1],16)
            green_decimal_var = sint(hex_str[1:2] + hex_str[1:2],16)
            blue_decimal_var = sint(hex_str[2:3] + hex_str[2:3],16)
            return "(%d,%d,%d)" % (red_decimal_var, green_decimal_var, blue_decimal_var)
	else:
		return ""

if __name__ == u"__main__":
    wf = Workflow()
    sys.exit(wf.run(main))

然后我们就可以通过Workflow -> Add Templates -> Essentials -> Script Filter to Script创建一个Workflow，然后通过上面提到的方法进入设置页面打开Workflow所在目录，按照alfred-workflow的Python库的安装方式安装设置好alfred-workflow，然后将写好的Python脚本放到相应的位置，最终目录里头的内容如下：

目录结构

然后再回到Workflow设置页面设置一下keyword和调用Python脚本的方法和参数就OK了。

QQ20150511-7@2x

同理可以再设置一个HexToRGB的行为：

QQ20150511-8@2x

转换成功到了之后，我们把结果保存到剪贴板中，并且通过鼠标拖拽Script Filter节点上的小圆点到Copy to Clipboard节点上，这样就能把Script Filter中获得的结果保存到系统的剪贴板中了。

Screen Shot 2015-05-11 at 11.35.16 PM

最后来个实际使用的截图吧：

Screen Shot 2015-05-11 at 11.38.12 PM

折腾完毕。