拓冰网站定制 
macOS 上正确安装 Python 与构建开发环境《Hitchhikers Guide to Python》macOS 安装指南详解【免费下载链接】python-guidePython best practices guidebook, written for humans.项目地址: https://gitcode.com/gh_mirrors/py/python-guide本篇技术指南改编自《Hitchhikers Guide to Python》本仓库python-guide中的 macOSOS X平台 Python 安装指南系统讲解如何在 macOS 上以“正确的方式”安装 Python 解释器、包管理工具Setuptools / pip与虚拟环境Virtualenv / Pipenv。读完本文你将掌握从零搭建一套可用于真实项目开发、依赖隔离、可复现的 macOS Python 开发环境并理解为什么要舍弃系统自带 Python 而选择 Homebrew 方案。一、系统自带 Python够学习但不够开发官方指南明确指出macOS 在 10.8 到 12.3 之间的版本默认自带 Python 2.7。如果你的系统处于该区间理论上开箱即可使用无需额外安装任何东西。但指南同时给出了非常关键的建议系统自带的 Python 版本很适合学习但不适合用于开发。它很可能落后于官方当前 Python 版本该版本被视为稳定的生产版本。原因不难理解系统 Python 由 Apple 维护用于支撑系统自身工具链其版本通常较旧且不应被随意改动否则可能破坏依赖它的系统组件。在开始构建真实世界应用之前官方建议务必先安装下文所述的开发工具链——尤其是 Setuptools它能让后续安装与管理第三方 Python 库变得异常简单。二、Doing it Right安装一个“真正的” Python“正确的方式”分三步安装 C 编译器 → 安装 Homebrew 包管理器 → 用 Homebrew 安装 Python。1. 安装 C 编译器安装 Python 之前你需要一个 C 编译器。最快的途径是安装 Xcode Command Line Tools$ xcode-select --install也可以从 Mac App Store 下载完整的 Xcode或安装精简但非官方的 OSX-GCC-Installer 包。仓库文档给出了两条重要的注意事项如果已经装了 Xcode不要再装 OSX-GCC-Installer两者组合可能引发难以排查的问题全新安装 Xcode 后仍需在终端执行xcode-select --install补装命令行工具。2. 安装 Homebrew 包管理器熟悉 Linux 的用户会发现 macOS 虽然自带大量 Unix 工具却缺少一个像样的包管理器而 Homebrew 恰好填补了这个空缺。打开Terminal或其他终端模拟器执行$ /usr/bin/ruby -e $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)说明这是文档中记录的经典安装命令基于 Ruby。仓库另一篇 Python 3 安装指南 使用的是新版 bash 安装命令/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)实际安装时请以 Homebrew 官网当前安装脚本为准。脚本会在安装开始前说明它将做哪些更改并请求确认。3. 将 Homebrew 目录加入 PATH安装完成后把 Homebrew 目录放到PATH环境变量的最前面确保python、pip等命令优先指向 Homebrew 的安装。在~/.profile文件底部追加export PATH/usr/local/bin:/usr/local/sbin:$PATH4. 用 Homebrew 安装 Python 2.7$ brew install python2由于python2是一个 “keg”按版本隔离的安装包不会默认链接进/usr/local/bin需要再次更新PATH指向新安装export PATH/usr/local/opt/python2/libexec/bin:$PATHHomebrew 会将可执行文件命名为python2这样你仍然可以用python命令运行系统自带的 Python。安装完成后可用以下命令验证各解释器$ python -V # Homebrew 安装的 Python 3 解释器若已安装 $ python2 -V # Homebrew 安装的 Python 2 解释器 $ python3 -V # Homebrew 安装的 Python 3 解释器若已安装5. 版本前提说明重要必须指出的是根据仓库中的 选择 Python 解释器指南Python 2 已于 2020 年 1 月 1 日终止生命周期EOL当前绝大多数生产应用使用 Python 3官方强烈推荐新项目一律使用 Python 3。因此brew install python2属于历史操作路径——在新系统上 Homebrew 已不再提供python2包应优先阅读仓库中的 macOS 上安装 Python 3 指南执行brew install python即可。本指南的 Python 2 章节主要用于理解历史最佳实践与系统自带 Python 的演进背景。三、Setuptools 与 pipPython 包管理的基石安装完 Python 后下一个关键步骤是包管理工具。Homebrew 会顺带为你安装 Setuptools 和 pip。Setuptools让你能通过一条命令easy_install从网络下载并安装任何符合规范的 Python 软件也能以很小的成本为自己的 Python 软件添加这种网络安装能力。pip是安装和管理 Python 包的首选工具。文档明确评价pip 在多个方面优于easy_install且仍在积极维护中。验证安装$ pip2 -V # 指向 Homebrew 安装的 Python 2 解释器的 pip $ pip -V # 指向 Homebrew 安装的 Python 3 解释器的 pip若已安装对应地仓库的 Linux 安装指南 也强调 setuptools 与 pip 是最关键的两个第三方包Python 2.7.9 及以后、Python 3.4 及以后的版本已默认内置 pip可通过command -v pip检查。四、虚拟环境解决“项目 X 要 1.x项目 Y 要 4.x”的困境虚拟环境Virtual Environment是隔离不同项目依赖的关键工具它为每个项目创建独立的 Python 环境从而解决“项目 X 依赖 Django 1.10而项目 Y 需要 Django 1.8”这类版本冲突同时让你的全局site-packages目录保持干净、可控。文档在此处引导读者进入仓库的 Pipenv Virtual Environments 教程那里提供了完整的上手指南用pip install --user pipenv安装 Pipenv高级依赖管理器理念类似 Node.js 的 npm 与 Ruby 的 bundler在项目目录执行pipenv install requests自动创建Pipfile并建立虚拟环境用pipenv run python main.py运行脚本、pipenv shell进入项目专属 shell。若你更偏好底层工具也可以用 virtualenv$ pip install virtualenv $ cd project_folder $ virtualenv venv $ source venv/bin/activate # 激活后提示符左侧出现 (venv) $ deactivate # 退出虚拟环境配合 pip 与 Virtualenv 的进一步配置指南还可以通过export PIP_REQUIRE_VIRTUALENVtrue或pip.conf中require-virtualenv true强制 pip 只能在激活的虚拟环境中安装包避免误装到全局并用pip freeze requirements.txt/pip install -r requirements.txt实现跨环境、跨部署、跨开发者的依赖一致性。五、整体安装脉络与仓库定位在《Hitchhikers Guide to Python》的项目结构中安装篇位于 docs/starting/installation.rst其目录导航见 docs/contents.rst.inc按“先选解释器 → 再按平台安装 → 最后配虚拟环境”的思路组织先读 选择 Python 解释器2 vs 3明确选型新项目一律 Python 3按平台选择安装指南macOS本指南 osx.rst 与 Python 3 版、Windows、Linux最后进入 虚拟环境与 Pipenv 教程 完成开发环境收尾。这条路径正是官方推荐的“Properly Installing Python”正确安装 Python的完整流程系统自带 Python 只可用于学习 → 安装 C 编译器与 Homebrew → 用 Homebrew 安装真正的 Python → 安装 Setuptools/pip → 用虚拟环境隔离项目依赖。按此流程操作你就拥有了一套适合真实项目开发、依赖清晰、易于复现的 macOS Python 开发环境。【免费下载链接】python-guidePython best practices guidebook, written for humans.项目地址: https://gitcode.com/gh_mirrors/py/python-guide创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 macOS 上正确安装 Python 与构建开发环境：《Hitchhiker‘s Guide to Python》macOS 安装指南详解
macOS 上正确安装 Python 与构建开发环境《Hitchhikers Guide to Python》macOS 安装指南详解【免费下载链接】python-guidePython best practices guidebook, written for humans.项目地址: https://gitcode.com/gh_mirrors/py/python-guide本篇技术指南改编自《Hitchhikers Guide to Python》本仓库python-guide中的 macOSOS X平台 Python 安装指南系统讲解如何在 macOS 上以“正确的方式”安装 Python 解释器、包管理工具Setuptools / pip与虚拟环境Virtualenv / Pipenv。读完本文你将掌握从零搭建一套可用于真实项目开发、依赖隔离、可复现的 macOS Python 开发环境并理解为什么要舍弃系统自带 Python 而选择 Homebrew 方案。一、系统自带 Python够学习但不够开发官方指南明确指出macOS 在 10.8 到 12.3 之间的版本默认自带 Python 2.7。如果你的系统处于该区间理论上开箱即可使用无需额外安装任何东西。但指南同时给出了非常关键的建议系统自带的 Python 版本很适合学习但不适合用于开发。它很可能落后于官方当前 Python 版本该版本被视为稳定的生产版本。原因不难理解系统 Python 由 Apple 维护用于支撑系统自身工具链其版本通常较旧且不应被随意改动否则可能破坏依赖它的系统组件。在开始构建真实世界应用之前官方建议务必先安装下文所述的开发工具链——尤其是 Setuptools它能让后续安装与管理第三方 Python 库变得异常简单。二、Doing it Right安装一个“真正的” Python“正确的方式”分三步安装 C 编译器 → 安装 Homebrew 包管理器 → 用 Homebrew 安装 Python。1. 安装 C 编译器安装 Python 之前你需要一个 C 编译器。最快的途径是安装 Xcode Command Line Tools$ xcode-select --install也可以从 Mac App Store 下载完整的 Xcode或安装精简但非官方的 OSX-GCC-Installer 包。仓库文档给出了两条重要的注意事项如果已经装了 Xcode不要再装 OSX-GCC-Installer两者组合可能引发难以排查的问题全新安装 Xcode 后仍需在终端执行xcode-select --install补装命令行工具。2. 安装 Homebrew 包管理器熟悉 Linux 的用户会发现 macOS 虽然自带大量 Unix 工具却缺少一个像样的包管理器而 Homebrew 恰好填补了这个空缺。打开Terminal或其他终端模拟器执行$ /usr/bin/ruby -e $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)说明这是文档中记录的经典安装命令基于 Ruby。仓库另一篇 Python 3 安装指南 使用的是新版 bash 安装命令/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)实际安装时请以 Homebrew 官网当前安装脚本为准。脚本会在安装开始前说明它将做哪些更改并请求确认。3. 将 Homebrew 目录加入 PATH安装完成后把 Homebrew 目录放到PATH环境变量的最前面确保python、pip等命令优先指向 Homebrew 的安装。在~/.profile文件底部追加export PATH/usr/local/bin:/usr/local/sbin:$PATH4. 用 Homebrew 安装 Python 2.7$ brew install python2由于python2是一个 “keg”按版本隔离的安装包不会默认链接进/usr/local/bin需要再次更新PATH指向新安装export PATH/usr/local/opt/python2/libexec/bin:$PATHHomebrew 会将可执行文件命名为python2这样你仍然可以用python命令运行系统自带的 Python。安装完成后可用以下命令验证各解释器$ python -V # Homebrew 安装的 Python 3 解释器若已安装 $ python2 -V # Homebrew 安装的 Python 2 解释器 $ python3 -V # Homebrew 安装的 Python 3 解释器若已安装5. 版本前提说明重要必须指出的是根据仓库中的 选择 Python 解释器指南Python 2 已于 2020 年 1 月 1 日终止生命周期EOL当前绝大多数生产应用使用 Python 3官方强烈推荐新项目一律使用 Python 3。因此brew install python2属于历史操作路径——在新系统上 Homebrew 已不再提供python2包应优先阅读仓库中的 macOS 上安装 Python 3 指南执行brew install python即可。本指南的 Python 2 章节主要用于理解历史最佳实践与系统自带 Python 的演进背景。三、Setuptools 与 pipPython 包管理的基石安装完 Python 后下一个关键步骤是包管理工具。Homebrew 会顺带为你安装 Setuptools 和 pip。Setuptools让你能通过一条命令easy_install从网络下载并安装任何符合规范的 Python 软件也能以很小的成本为自己的 Python 软件添加这种网络安装能力。pip是安装和管理 Python 包的首选工具。文档明确评价pip 在多个方面优于easy_install且仍在积极维护中。验证安装$ pip2 -V # 指向 Homebrew 安装的 Python 2 解释器的 pip $ pip -V # 指向 Homebrew 安装的 Python 3 解释器的 pip若已安装对应地仓库的 Linux 安装指南 也强调 setuptools 与 pip 是最关键的两个第三方包Python 2.7.9 及以后、Python 3.4 及以后的版本已默认内置 pip可通过command -v pip检查。四、虚拟环境解决“项目 X 要 1.x项目 Y 要 4.x”的困境虚拟环境Virtual Environment是隔离不同项目依赖的关键工具它为每个项目创建独立的 Python 环境从而解决“项目 X 依赖 Django 1.10而项目 Y 需要 Django 1.8”这类版本冲突同时让你的全局site-packages目录保持干净、可控。文档在此处引导读者进入仓库的 Pipenv Virtual Environments 教程那里提供了完整的上手指南用pip install --user pipenv安装 Pipenv高级依赖管理器理念类似 Node.js 的 npm 与 Ruby 的 bundler在项目目录执行pipenv install requests自动创建Pipfile并建立虚拟环境用pipenv run python main.py运行脚本、pipenv shell进入项目专属 shell。若你更偏好底层工具也可以用 virtualenv$ pip install virtualenv $ cd project_folder $ virtualenv venv $ source venv/bin/activate # 激活后提示符左侧出现 (venv) $ deactivate # 退出虚拟环境配合 pip 与 Virtualenv 的进一步配置指南还可以通过export PIP_REQUIRE_VIRTUALENVtrue或pip.conf中require-virtualenv true强制 pip 只能在激活的虚拟环境中安装包避免误装到全局并用pip freeze requirements.txt/pip install -r requirements.txt实现跨环境、跨部署、跨开发者的依赖一致性。五、整体安装脉络与仓库定位在《Hitchhikers Guide to Python》的项目结构中安装篇位于 docs/starting/installation.rst其目录导航见 docs/contents.rst.inc按“先选解释器 → 再按平台安装 → 最后配虚拟环境”的思路组织先读 选择 Python 解释器2 vs 3明确选型新项目一律 Python 3按平台选择安装指南macOS本指南 osx.rst 与 Python 3 版、Windows、Linux最后进入 虚拟环境与 Pipenv 教程 完成开发环境收尾。这条路径正是官方推荐的“Properly Installing Python”正确安装 Python的完整流程系统自带 Python 只可用于学习 → 安装 C 编译器与 Homebrew → 用 Homebrew 安装真正的 Python → 安装 Setuptools/pip → 用虚拟环境隔离项目依赖。按此流程操作你就拥有了一套适合真实项目开发、依赖清晰、易于复现的 macOS Python 开发环境。【免费下载链接】python-guidePython best practices guidebook, written for humans.项目地址: https://gitcode.com/gh_mirrors/py/python-guide创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考