114

What I'm trying to do here is to make python3 as my default python. Except the python 2.7 which automatically installed on mac, I installed python3 with homebrew. This is the website that I'm following. http://docs.python-guide.org/en/latest/starting/install3/osx/#install3-osx

I guess I followed every instruction well, got xcode freshly installed, Command line tools, and homebrew. But here's my little confusion occurs.

The script will explain what changes it will make and prompt you before the installation begins. Once you’ve installed Homebrew, insert the Homebrew directory at the top of your PATH environment variable. You can do this by adding the following line at the bottom of your ~/.profile file

export PATH=/usr/local/bin:/usr/local/sbin:$PATH

I was really confused what this was, but I concluded that I should just add this following line at the bottom of ~/.profile file. So I opened the ~/.profile file by open .profile in the terminal, and added following line at the bottom. And now it looks like this.

export PATH=/usr/local/bin:/usr/local/sbin:$PATH
# Setting PATH for Python 3.6
# The original version is saved in .profile.pysave
export PATH=/usr/local/bin:/usr/local/sbin:$PATH

And then I did brew install python, and was hoping to see python3 when I do python --version. But it just shows me python 2.7.10. I want my default python to be python3 not 2.7

And I found a little clue from the website.

Do I have a Python 3 installed?

$ python --version
Python 3.6.4

If you still see 2.7 ensure in PATH /usr/local/bin/ takes pecedence over /usr/bin/

Maybe it has to do something with PATH? Could someone explain in simple English what PATH exactly is and how I could make my default python to be python3 when I run python --version in the terminal?

8
  • 4
    What's wrong with just running python3 (and pip3, etc.)? That's still the recommended solution for *nix systems at least until 2020. (If the extra character is too much for you, just alias py or py3 to python3, and it's even shorter than python.) Or, alternatively, have you considered using venv/virtualenv?
    – abarnert
    Apr 7, 2018 at 6:04
  • 1
    Meanwhile, if you want to understand what PATH is, you should not search Python-related sources for that, but general Unix resources. SuperUser or AskDifferent might be more relevant than StackOverflow, but really, you're asking someone to write a tutorial, there are already plenty of better tutorials online.
    – abarnert
    Apr 7, 2018 at 6:06
  • 1
    There are two different use cases here: yours and your system's. Let macos use the installed 2.7 version, otherwise you will have dependency issues. I would highly recommend installing second, dedicated distribution (such as Anaconda/conda, like virtualenv suggested above) if you want to program in python.
    – anon01
    Apr 7, 2018 at 7:15
  • Adding things to the PATH twice just make things (a very little bit) slower. exporting PATH which is almost certainly already exported on your behalf by the system is also not useful.
    – tripleee
    Apr 7, 2018 at 7:28
  • I'm a beginner here in python so I just thought it should print python3. That's because what the website says so. If there's no problem with just typing python3, I will do that. Thanks for the explanation guys.Cheers :)
    – Sambo Kim
    Apr 7, 2018 at 10:07

5 Answers 5

205

Probably the safest and easy way is to use brew and then just modify your PATH:

First update brew:

brew update

Next install python:

brew install python

That will install and symlink python3 to python, for more details do:

brew info python

Look for the Caveats:

==> Caveats
Python has been installed as
  /usr/local/bin/python3

Unversioned symlinks `python`, `python-config`, `pip` etc. pointing to
`python3`, `python3-config`, `pip3` etc., respectively, have been installed into
  /usr/local/opt/python/libexec/bin

Then add to your path /usr/local/opt/python/libexec/bin:

export PATH=/usr/local/opt/python/libexec/bin:$PATH

The order of the PATH is important, by putting first the /usr/local/opt/python/libexec/bin will help to give preference to the brew install (python3) than the one is in your system located in /usr/bin/python

8
67

Before we make the changes, the default version of python in my system was python 2.7.17.

python --version

Python 2.7.17

To make python3 as default python by replacing python2 in Ubuntu.

  1. Open Terminal
  2. cd
  3. nano ~/.bashrc
  4. alias python=python3 (Add this line on top of .bashrc file)
  5. Press ctr+o (To save the file)
  6. Press Enter
  7. Press ctr+x (To exit the file)
  8. source ~/.bashrc OR . ~/.bashrc (To refresh the bashrc file)

python --version

Python 3.7.5

4
  • 3
    Answer is straight to the point. It worked on macOS catalina 10.15.3 Jul 26, 2020 at 7:37
  • 3
    Although the version is changed to python3, but the default python is still python 2.7. Like when you open a new jupyter notebook, or install a new package, the active python is still 2.7.
    – nightrain
    Aug 26, 2020 at 15:35
  • 1
    Very helpful answer in case ~/.bashrc not found. check for ~/.bash_profile or ~/.zshenv.
    – Pravanjan
    Sep 17, 2020 at 14:04
  • 2
    As @nightrain points out this will only work some of the time. You're not actually picking a new version of python system wide, this only alters the usage of python when invoked directly from the command line (and not from other programs which will not use your bash aliases)
    – kingsfoil
    Mar 24 at 6:57
27

Changing the default python version system wide can break some applications that depend on python2. The alternative solution would be to create an alias.

If you are using zsh (the default on Mac OS) run the following from terminal:

echo 'alias python="python3"' >> ~/.zshrc
echo 'alias pip="pip3"' >> ~/.zshrc
4
  • this only works for terminal sessions, however if you close your terminal and reopen your terminal you have source bashrc again. Is there a permanent solution?
    – BigDreamz
    Jun 18, 2021 at 16:19
  • @BigDreamz I don't understand what you mean by "permanent" ? Jun 18, 2021 at 16:22
  • 2
    never mind, it works for me now. I had to source zshrc
    – BigDreamz
    Jun 18, 2021 at 21:41
  • works for macOS 12.6 when python is installed with brew, also had to do the same for pip3 Jan 22 at 16:12
5

According to this S.O. post, changing the default Python interpreter could possibly break some applications that depend on Python 2.

The post also refers to using aliasing as a solution, and this link might also be a good reference on how to do that.

Personally, I just type "Python3" before I run scripts or go into a shell environment instead of "python".

1
  • 1
    I decided that this is the best option, as you said: "python3". I just have to remember to type as well: "pip3" when installing new modules. Hehe. Feb 11, 2020 at 3:38
0

I was facing the same issue with Homebrew, but had to do an extra manual step to fix the issue, because I got too new Python 3.11 instead of wanted Python 3.10

  • I installed awscli from Homebrew which pulled in Python 3.11 installation on my Homebrew

  • I had to reinstall Python 3.10

brew install [email protected]
brew link [email protected]

However even after this python3 command pulled the wrong version of Python. So as a missing manual fix, I had to do:

ln -s /opt/homebrew/bin/python3.10 /opt/homebrew/bin/python3

Then you can check if /opt/homebrew/bin gets preference (is higher) when you check PATH configured in the .rc file of your shell:

echo $PATH | tr ":" "\n"
/opt/homebrew/bin
/Users/moo/.local/bin
/Users/moo/go/bin
/Users/moo/.go/bin
/Users/moo/.nvm/versions/node/v16.15.0/bin
/Users/moo/.zsh/bin
...

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.