I just upgraded to Mojave from High Sierra and installed Xcode plus its command line tools and additional tools. Nothing will compile from the terminal, everything says /usr/include is missing!

I checked and ALL the Dev related dirs under /usr are missing!

Any idea how to fix?


You have to run another step after installing the command line tools:

sudo installer -pkg /Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg -target /

Why? Apple have introduced a new build tool dance - system includes are now only kept under a specific SDK's path with Xcode 10 onwards:

The Command Line Tools package installs the macOS system headers inside the macOS SDK. Software that compiles with the installed tools will search for headers within the macOS SDK [...] provided by either Xcode [...] or the Command Line Tools [...] depending on which is selected using xcode-select.


The command line tools will search the SDK for system headers by default. However, some software may fail to build correctly against the SDK and require macOS headers to be installed in the base system under /usr/include [emphasis added]. If you are the maintainer of such software, we encourage you to update your project to work with the SDK or file a bug report for issues that are preventing you from doing so. As a workaround, an extra package is provided which will install the headers to the base system. In a future release, this package will no longer be provided. You can find this package at: /Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg

To make sure that you're using the intended version of the command line tools, run xcode-select -s <path to Xcode> or xcode select -s /Library/Developer/CommandLineTools after installing.

  • 3
    Nicholas Smith: How did you find this out? – Bryan Dunphy Sep 28 '18 at 17:27
  • 2
    I don't even have a Packages directory?! – nohillside Sep 28 '18 at 17:54
  • I saw it on StackOverflow at some point and it stuck in my head. – Nicholas Smith Sep 28 '18 at 21:08
  • You probably need the command-line tools before attempting this. See this answer. – ephsmith Sep 29 '18 at 11:43
  • 2
    You might need to use sudo to get this command to work – stackErr Oct 31 '18 at 23:46

The "why" is because Apple has deprecated having a /usr/include distinct from the SDK. You shouldn't rely on having it going forward.

The compilers know already to find their includes inside the SDK, so there's no real need for the /usr/include directory any more. You can find the SDK's install directory for the include files using xcrun --show-sdk-path

  • 5
    Is this documented anywhere? – Mark Sep 30 '18 at 18:57
  • Except the fact that macOS is (was) unix04 certified. – lanza Dec 9 '18 at 8:59
  • Being conformant with the Single Unix Specification or POSIX does not require that /usr/include be present in the file system. – Perry Dec 12 '18 at 15:15
  • And yes, it's documented in the SDK documentation. – Perry Dec 12 '18 at 15:15
  • 1
    Well, MacPorts seems to be doing just fine, even though most of the packages use autoconf. We had less than five broken packages out of many thousands. – Perry Dec 18 '18 at 22:45

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .