Jacin Blog
Macbook配置开发环境
Python 开发

Macbook配置开发环境

JACIN9 分钟阅读
环境配置
AI 摘要

这份笔记面向在 MacBook 上搭建 Python 后端开发环境的开发者，背景是本地工具链、编辑器、终端和 GitHub 连接配置较多，容易在新机器或多项目环境中反复踩坑。内容先给出 VS Code/Cursor 的 Python 调试配置示例，包括用 debugpy 启动 FastAPI 的 uvicorn 模块、调试当前文件、设置 PYTHONPATH，以及在 settings.json 中指定项目虚拟环境解释器、额外分析路径和保存格式化行为。随后补充 Python 与 Git 相关插件选择，并记录 PyCharm 在网络异常时可通过代理设置或开启 TUN 模式处理访问问题。GitHub SSH 部分覆盖 Homebrew 安装 Git、使用 ssh-keygen 生成 RSA 密钥、为多账户区分密钥文件名、启动 ssh-agent、ssh-add 加载私钥、把公钥添加到 GitHub，以及用 ssh -T 验证认证结果；若代理导致 22 端口异常，则参考 GitHub 官方的 HTTPS 端口 SSH 方案。后续还整理了 iTerm2、Oh My Zsh、agnoster 主题的安装入口和 zsh 配置位置，并列出 WebStorm、PyCharm、Docker、Cursor、抓包与远程控制等常用软件。阅读时应结合自己的 ARM 或 x86 架构、代理环境、项目路径和密钥命名调整命令，尤其要始终区分公钥与私钥，避免把私钥内容上传到平台。

目录#

[[toc]]

博主是一名Python后端开发，有时候环境太多 需要配置太多，故做此文章

环境Macbook ，请注意自己的是ARM 还是x86 结构

Vscode/Cursor配置Python debug#

配置Debug#

launch.json

python 
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: FastAPI",
            "type": "debugpy",
            "request": "launch",
            "module": "uvicorn",
            "args": [
                "app.main:app",
                "--host",
                "0.0.0.0",
                "--port",
                "8000",
                "--reload",
                "--log-level",
                "debug"
            ],
            "justMyCode": true,
            "env": {
                "PYTHONPATH": "${workspaceFolder}"
            }

        },
        {
            "name": "Python: Current File",
            "type": "debugpy",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "justMyCode": true,
            "env": {
                "PYTHONPATH": "${workspaceFolder}"
            }
        }
    ]
}

settings.json

python 
{
    "python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python",
    "python.pythonPath": "${workspaceFolder}/.venv/bin/python",
    "python.analysis.extraPaths": [
        "${workspaceFolder}"
    ],
    "python.terminal.activateEnvironment": true,
    "[python]": {
        "editor.formatOnSave": false,
        "editor.defaultFormatter": null
    },
    "python.formatting.provider": "none",
    "editor.formatOnSave": false,
    "editor.rulers": [
        88
    ],
    "files.trimTrailingWhitespace": false,
    "files.insertFinalNewline": false,

}

插件使用#

关于python的：

关于Git

Pycharm 配置网络#

有时候网络不行

或者开启 TUN 模式

【终端模式】

Mac配置Github的ssh:#

Mac使用homebrew安装git (相关下载直接AI

text 
新建一个ssh-keygen
ssh-keygen -t rsa -b 4096 -C "my_email@example.com"
# 后面邮箱写自己github账号邮箱

为方便多个公私钥的配置，请将文件名加以区分，例如：id_rsa_github.

下面的passphrase直接默认回车为空即可

这时候在默认路径下就生成了两个文件，公钥和私钥。

SSH Key添加到ssh-agent

text 
eval $(ssh-agent -s)
# 返回agent的Pid：

接着输入：

text 
ssh-add ~/.ssh/id_rsa （这个文件就是你之前改的路径名）

打开id_rsa_github.pub文件，复制文件内容到github （.pub是公钥，公钥放在平台上，私钥在自己手中，这里采用的算法是RSA非对称加密体制，即解密和加密的密钥是不同的）

进入自己的github个人主页，添加ssh key公钥，记得把id_rsa_github.pub文件内容全部复制过去，包括-----BEGIN OPENSSH PRIVATE KEY-----等。创建好即可。

text 
ssh -T git@github.com
[输入yes： 将The authenticity of host 'github.com (20.205.243.166)' can't be established.
这个是验证，出现以下信息即代表成功。
Hi xxx! You've successfully authenticated......

如果有代理，会出现22端口异常（挂代理的话访问github会很快）

处理方法如下：

https://docs.github.com/zh/authentication/troubleshooting-ssh/using-ssh-over-the-https-port

配置ITerm2 +Zsh#

https://juejin.cn/post/6844904178075058189

下载

iTerm2

Oh My Zsh is an open source, community-driven framework for managing your zsh configuration.

python 
# via curl
sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

# via wget
sh -c "$(wget -O- https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

vim ~/.zshrc

ZSH_THEME="agnoster”

软件部分#

非必要不要下载 盗版软件！！！！

Webstorm 非商业版本

Pycharm 社区版

Sublime

Docker

Vscode/Cursor

Proxy-Tools

SourceTree( Github Desktop)

Todesk

IINA(播放器）

Charles (ProxyPin ，抓包工具，网络分析）

评论

还没有评论，来发第一个吧