闇のpath_helperに対する防衛術 (※2025年時点)

About this scraps

macOSの path_helper について掘り下げて悩んでまとめる

path_helper問題の歴史 (2025年時点)

• 1999年:
  • zsh 3.0.6, 3.1.6 リリース^[1]。
  • /etc/zshenv 以降の /etc/z* ファイルをスキップする NO_GLOBAL_RCS が追加された^[2]。
• 2008年:
  • path_helper は OS X Leopard から追加されたよう^[3]。
    この時点ではバイナリではなく、スクリプトとして実装されていた。
  • path_helper の構造的問題がApple support communityに投稿される^[4]。
• 2009年:
  • OS X Snow Leopard リリース。
  • path_helper が現在のバイナリ形式に変更された。なんと2021年までソースコードが公開されていた模様。現在でも2012年ごろのソースは閲覧できる^[5]。
• 2012年?:
  • path_helper を呼ぶコードは zprofile ではなく zshenv に置かれていたよう^[6][7]。
• 2013年:
  • 「path_helper は壊れている！」「/etc/zshenv を /etc/zprofile にすれば解決する！」という論争が起こる^[8]。
• 2015年9月末
  • OS X El Capitan リリース。
  • path_helper の呼び出しコードが /etc/zprofile に移動した^[9][10]。
• 2015年末~2016年?:
  • zshのオプション no_global_rcs による対策例が投稿されはじめる ^[10:1][11]。
• 2017年:
  • macOS用の.NET Core がインストール時に /etc/paths.d/dotnet を生成する事例が投稿される^[12]。
• 2018年:
  • brew install時のオプション --without-etcdir が削除された^[13][14]。
  • 当該PRに基づくissueでは非常に激しい議論の痕が残されている。
• 2021年:
  • VMware Fusionが /etc/paths.d/com.vmware.fusion.public を残していく事例が投稿される^[15]。
• 2023年:
  • 私が手元でインストールしたgoが /etc/paths.d/go を生成していた。

脚注

1. 1999-08-01 : Releases 3.0.6 & 3.1.6 ↩︎

2. New features in zsh version 3.1.6 (beta version) - Release Notes ↩︎

3. 最近のMac OSXで、PATHをスマート(?)に管理するやり方。 - こせきの技術日記 ↩︎

4. path_helper is seriously fubar'd - Apple Community ↩︎

5. Source Browser - opensource.apple.com (アーカイブ) ↩︎

6. 【Mac】zshをサブシェルで起動するとPATHがおかしくなる - よんちゅBlog ↩︎

7. OSX + screen + rbenv でハマった話 - kurainの壺 ↩︎

8. The notice about path_helper on OS X is incorrect · Issue #381 · sorin-ionescu/prezto ↩︎

9. Mac OSX El Capitan での ~/.zshenv の扱いについて #MacOSX - Qiita ↩︎

10. El Capitanにしたらzsh上でのPATHが上書きされた - すぎゃーんメモ ↩︎ ↩︎

11. zshでPATHがおかしくなる問題の解決編 - 理系学生日記 ↩︎

12. path_helper ($PATHを設定するコマンド) (macOS, /etc/paths.d, /etc/paths, shell間をまたいだパス設定) - いろいろ備忘録日記 ↩︎

13. zsh: default unicode9, remove options. by MikeMcQuaid · Pull Request #34422 · Homebrew/homebrew-core ↩︎

14. Akira Matsudaさんのポスト / X ↩︎

15. VMware Fusionのアンインストール後も/etc/paths.d/com.vmware.fusion.publicが残る - あとがきのようなもの ↩︎

主張・思想

人々が何を主張しているのかわからなくなってきた

派閥

1. ~/.zshenv より後で PATH をいじって欲しくないよ派:
   • これはほんとうにそう
   • PATH 以外はいじられないので、〇〇env としての体裁は保てている?
2. そもそも path_helper は 壊れている・バグがある よ派:
   • 正直わからない
   • /etc/zshenv に置かれていたのは問題あると思うケド(全シェルで毎回PATH再設定してるのはさすがにちょっと変)……
   • 2025年現在も壊れてるって主張は、ちょっとキレすぎじゃないかナ
3. path_helper が PATH の順番をいじらなければ問題はなかったはずだよ派:
   • これもほんとうにそう
   • 事前に PATH の値を取得しておいて、それを尊重するような動作にして欲しかった
   • (もしかしてmacOS的には zshenv を使って欲しくないのか?)
4. /etc/paths, /etc/paths.d/* をいじっちゃえばいいよ派:
   • わからない
   • 全ユーザに影響が及ぶし、起動スクリプトの中にこれに依存するものがないとは言い切れない
5. no_global_rcs, --without-etcdir で丸ごとスキップしちゃえばいいよ派:
   • わからない
   • 2023年時点でも /etc/paths.d は使われているので、path_helper を排除するのは厳しい
   • ただ、昔はこれが唯一無二の解決策だった可能性はある
6. 諦めて ~/.zshrc で設定するのが一番楽だよ派:
   • 正直わかる
   • ただそれは 〇〇rc の責任じゃないと思う

要約

1. macOSには path_helper というPATH設定ヘルパが存在する
2. ~/.zshenv より後に呼ばれるので、他環境のdotfileを持ってくるとPATHがおかしな順番になることがある
3. この子は問題なく動作するが、デフォルトのコマンドを置き換えたいときにとても困る
4. 一部のプログラムはpath_helperが動作することを前提にしているので、我々はこの子と共存しなければならない

path_helper とうまくやっていくには?

上述の通り path_helper は2025年現在も使われているため、削除・スキップ等の手段で解決するのはよろしくない
ではどうすればよいのか

Apple (macOS) の意図を推測する

OS X Leopard ~ (path_helper 実装初期)

この時点では path_helper は /etc/zshenv で呼ばれていたことから、いかなる状況でもシェルコマンド実行前に path_helper が実行されること を想定していた可能性が高い。

どのようにシェルが起動されようと滞りなくコマンドサーチパスが設定されるよう、 (中略) zsh用の「/etc/zshenv」に、path_helperを実行するための記述が施されている。

2010/10/12, ZDNet Japan ^[1]

この時代のメジャーな解決策は /etc/paths.d/ にファイルを追加する……というものだったよう:

It is very handy. All you do is create a file in /etc/paths.d that contains a single line, the directory you want to add to your path.

2010/02/20, Apple community ^[2]

If you need to run your PHP commands as CLI sessions, you'll also probably need to add /opt/local/bin as a new path under /etc/paths.d work. For instance, something like this:

shell> sudo echo "/opt/local/bin" >> /etc/paths.d/macports

2008/09/23, Apple Mailing Lists ^[3]

Messing with the [/etc/|~/.] of [profile|bashrc] files may work, but it's somewhat of a hack. The /etc/paths.d/ directory is the way to go:

2008/12/07, serverfault ^[4]

echo "/some/other/path" >> /etc/paths.d/GoogleDev

same for /etc/manpaths.d
Just create files with the path/manpath additions you want in those locations.

This is one of the most awesome things Apple has done
2009/09/28, Ars OpenForum ^[5]

しかし、この頃から手放しで称賛されていたわけではなかった:

I've always been quite happy about most of the stuff Apple does. A lot of their solutions to problems are elegant and pretty. However, there are also some cases in which they do awful stuff under the hood. Stuff that makes me cringe in disgust.

Case in point, the new path_helper command.

2007/11/18, www.kilala.nl ^[6]

Snow Leopard 以前では、path_helper が呼ばれる前の段階で PATH が設定されてしまっており、本来設定されるべきでない値が返るバグが存在した:

However, if you want to change the order of path lists in /etc/paths, changing the order of lines in this file seems useless ! This because the PATH variable has an initial value of /usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin before a call to path_helper take place. While the origin of this initial value stay obscure to me, this is a true fact.

2008/06/24, SOFTEC.st ^[7]

つまり人類はもう15年以上このプログラムと格闘しているということになる

OS X El Capitan ~ (/etc/zprofile への移動)

zshのメーリングリストでパスの変更が報告されている。

That's good news, they used to have that code in /etc/zshenv which meant you had no way to override it. It only took them a few years to fix this.

2015/07/31, Zsh Mailing List Archive ^[8]

しかし、Appleが path_helperを /etc/zshenv から /etc/zprofile に移動した明確な動機は見つからなかった。この変更の詳細は不明だが、異なるシェル感の挙動を統一したかった意図もあったのではと個人的に考えている。

それまで、 path_helper の呼び出しは /etc/zshenv に加え /etc/profile にも書かれていた。このファイルは bash がログインシェルとして起動した際にのみ読み込まれるが、zsh (5.9 (arm-apple-darwin24.0.0)) では読み込まれない。
つまりzshは /etc/zshenv から、 bashは /etc/profile から path_helper を呼ぶことになる。

/etc/zshenv は常に読み込まれるため、以下のような挙動のねじれが発生する:

	インタラクティブシェル	非インタラクティブシェル
ログインシェル	bash/zsh	bash/zsh
非ログインシェル	zsh	zsh

このねじれを「ログインシェルとして起動した際 path_helper が一度だけ呼ばれる」という挙動に統一したかった可能性はある。シェルが起動するたびに path_helper が呼ばれてしまうと サブシェルを起動するだけでPATHの順序が変わる ことになり(多分)、挙動としてもなにやらおかしなことになってしまう。

脚注

1. Snow Leopard時代のパス管理術 - builder by ZDNet Japan ↩︎

2. How do I set the $PATH environment variab… - Apple Community ↩︎

3. Re: How to create/change an environment variable (path) for user "_www" in Mac OS-X Leopard ↩︎

4. mac osx - How do I set the global PATH environment variable on OS X? - Server Fault ↩︎

5. how do i add something to PATH in snow leopard? | Ars OpenForum ↩︎

6. kilala.nl - path_helper: sometimes Apple does kludgy, stupid things ↩︎

7. Mastering the path_helper utility of MacOSX ↩︎

8. Re: PSA: Mac OS X El Capitan upgrade might break your $PATH ↩︎

path_helper とは

プログラムの概要

path_helper 問題とは

なぜ人々はこのコマンドに苦しめられているのか

歴史

OS X Leopard で追加されて以来、 path_helper はさまざまな問題を引き起こしてきた。
ここではその歴史を振り返る。