小説Git6: macOSのフォルダー名

久しぶりの小説Git更新は、少々趣を変えてmacOSのVS CodeでGitを利用する時に陥りがちなトラブルとその対策についてお伝えします。この問題は、プロジェクトフォルダーとその上位フォルダーで日本語の特定の文字(ひらがな、カタカナの濁点と半濁点)を使っているときに出くわします。

macOSでプロジェクト名やプロジェクトを含む上位フォルダーの名前に、ひらがなやカタカナの濁点や半濁点、欧文のアクセント記号(éの上の記号です)が含まれていると、VS CodeでGitを使うことができません。「📁マン・カイン」の「ド」や「📁短編フォルダー」の「ダ」、「📁私が眠る時」の「が」などが含まれていると、VS CodeのGitプラグインはいくつかのコマンドが実行できなくなります。

「📁私眠る時」 プロジェクトでgit addを実行するとfatalエラーが出ます

これは、macOSのファイル名が採用した規格に起因する問題です。macOSはファイル名に使われる濁点や半濁点を「か」+「゛」の二文字合成で表現するNDFを採用していますが、WindowsやLinuxなど、そのほか多くのOSでは「が」を一つのコードで表現するNFCを採用しています。Macに保存されている「私が眠るとき」というフォルダーは、「私か゛眠る時」と記録されているので、「私が眠る時」で探しても見つからないため、さまざまな不具合が発生します。

プロジェクトフォルダーそのものだけはなく、その上位フォルダーに「短編フォルダー」という名前のフォルダーがあった場合も、同様の問題が起こります。(コンピューターのフォルダーの場所は、/Users/taiyo/Desktop/短編フォルタ゛ー/私か゛眠れない/のように記述されるためです)

この問題を回避する方法はいくつかあります。最も楽なのが、フォルダー名をASCII(俗にいう半角です)にする方法です。ローマ字で 📁watasi-ga-nemuru-toki にしてもいいし、英語で 📁 When-I-got-sleep にしてもいいかもしれません(空白をハイフンに置き換えたのは、半角の空白もまたトラブルの種になりかねないからです)。しかし、日本語で小説を書いているのだから 📁私が眠る時 と書きたいですよね。わかります。私もそうしています。そこで、ちょっとだけ「黒い画面」を使って回避する方法をお伝えします。

VS Codeを起動してプロジェクトフォルダーの上位フォルダーを開いてください。下の例では「小説」というフォルダーを開いています。

ここで、Git管理したいフォルダーの名前を、書き換えて、元に戻してください。

これでフォルダー名がNFCに変わり、VS CodeのGitで管理できるようになります。

異なるコード体系が混在できることに目を剥く方もいらっしゃるかもしれませんが、可能ですし、それほど大きな問題なく利用できます。macOSのNFD/NFC問題は2000年ごろはひどいことがいろいろ起こりましたが、徐々にマシになってきています。このドキュメントもいずれ無用になることでしょう。

コンテンツ一覧

  1. 小説Git 1:はじめに
  2. 小説Git 2:黒い画面でタタタターン
  3. 小説Git 3:VS Codeのインストールと最低限の設定
  4. 小説Git 4:Gitのインストール
  5. 小説Git 5: VS CodeのGit拡張機能
  6. 小説Git 6: macOSのフォルダー名

コメントを残す