开发环境:写代码、调试、运行、部署代码的整套软硬件组合。 一套完整链路:编辑器写代码 → 本地环境调试运行 → 版本控制管理代码变更 → 包管理器安装依赖库 → 服务器环境部署上线。 不管是Python脚本、后端服务,都离不开这套工具链。运维做脚本开发、自动化工作也必须熟练掌握。

一、版本控制系统 Git⭐重中之重

Git:分布式版本控制系统。用来记录代码每一次修改,回溯历史版本,多人协同开发。 解决问题:代码改乱可以回退;多人同时写代码不会互相覆盖;留存每一轮变更记录。

Git核心概念

  1. 工作区:你电脑本地看到的代码文件夹

  2. 暂存区(stage/index):临时存放准备提交的修改

  3. 本地仓库:本机保存完整版本历史数据库

  4. 远程仓库:云端仓库,Gitee/GitHub,存放代码备份,多人协作

工作流程:工作区修改 → add提交到暂存区 → commit提交本地仓库 → push推送到远程仓库。

高频常用命令

#初始化git仓库
git init

#把修改加入暂存区
git add .

#提交到本地仓库,写提交备注
git commit -m "feat:新增用户处理脚本"

#查看状态
git status

#查看提交历史
git log

#关联远程仓库
git remote add origin git@gitee.com:xxx/demo.git

#推送本地版本到远程
git push origin main

#拉取远程最新代码到本地
git pull origin main

#克隆远程仓库到本地
git clone git@gitee.com:xxx/demo.git

#创建分支
git branch dev

#切换分支
git checkout dev

#合并dev分支到main
git merge dev

分支概念

  • main/master:主分支,存放稳定可用代码;

  • dev:开发分支,日常开发;

  • 功能分支:开发某个单独功能,完成后合并回dev。

实操规范:禁止直接在main分支写代码,新建功能分支开发,测试完毕再合并。

Git忽略文件 .gitignore

配置哪些文件不要纳入版本管理。 示例 .gitignore

__pycache__/
*.pyc
*.log
.env
venv/
.DS_Store

缓存文件、日志、虚拟环境、密钥配置文件不要提交到仓库。

远程仓库

GitHub、Gitee。两种推送方式:

  1. HTTPS:每次推送输入账号密码;

  2. SSH密钥:配置本机公钥,免密推送,生产常用。

安全提醒:密码、密钥、数据库账号绝对不能提交进Git仓库

二、代码编辑器 / IDE

VS Code(首选,轻量通用)

支持几乎所有编程语言,免费开源。 核心插件:

  1. Python:Python语法高亮、代码提示、调试

  2. GitLens:可视化git提交记录

  3. Chinese:中文语言包

  4. Code‑Runner:一键运行脚本

  5. Pylint / Ruff:代码静态检查,提示语法、规范错误
    快捷键高频: Ctrl + P快速打开文件;Ctrl + Shift + P打开命令面板;Ctrl + 调出终端。

PyCharm(Python专用IDE)

适合大型Python项目,内置虚拟环境、调试、git、数据库工具。社区版免费。

VS Code适合轻量脚本;大型项目优先PyCharm。
IDE与编辑器区别:编辑器轻量化,需要装插件扩展能力;IDE内置全套调试、构建、环境工具。

三、包管理器 & 虚拟环境(Python)

包管理器:安装第三方开源库。 虚拟环境:为每一个项目创建独立隔离环境,不同项目依赖库版本互不干扰。 痛点:A项目需要requests2.20,B项目需要requests2.31,不隔离会版本冲突。

pip(Python官方包管理器)

#安装第三方库
pip install requests

#导出当前项目所有依赖清单
pip freeze > requirements.txt

#根据清单批量安装依赖
pip install -r requirements.txt

requirements.txt:项目依赖清单,提交到git,别人拿到项目一键安装全部依赖。

Python虚拟环境

方案1:python内置venv(无需额外安装)

#创建虚拟环境,文件夹venv
python -m venv venv

#激活虚拟环境
#Windows cmd
venv\Scripts\activate
#Linux / macOS
source venv/bin/activate

#退出虚拟环境
deactivate

激活成功终端前面出现(venv)标识,此时pip安装的库只属于当前项目。

⚠️虚拟环境文件夹venv一定要写入.gitignore,不要提交代码仓库。

方案2:conda(适合数据分析、多版本Python管理)

适合需要切换不同Python版本场景。

开发规范:每一个Python项目必须使用独立虚拟环境,禁止直接使用系统全局Python

四、终端工具

  1. Windows:Windows Terminal(推荐)、PowerShell;不要用老旧cmd。

  2. Linux:系统自带terminal;远程连接:Xshell、Tabby、FinalShell。

开发大量工作是在终端执行命令,熟悉基础命令行是必备能力。

五、调试工具

1. print打印调试(简单脚本快速用)

直接打印变量观察值,适合小脚本。缺点:代码里残留大量print,后期要手动删除。

2. IDE断点调试⭐正式项目

核心能力:设置断点,程序运行到断点暂停,可以查看所有变量的值,一步步单步执行,定位逻辑bug。

  • VS Code:点击行号左侧设置红点断点,F5启动调试;

  • PyCharm:点击行号断点,右键debug运行。

3. pdb 命令行调试(无图形界面服务器上调试)

Python内置调试库

import pdb
pdb.set_trace() #程序运行到这里暂停

六、环境变量与配置文件

环境变量:操作系统层面保存的键值对,用来存放配置、密钥、路径。 敏感信息(数据库密码、token密钥)禁止硬编码写在代码里面,写在环境变量或者本地配置文件。

.env配置文件

项目根目录.env,存放私有配置,加入.gitignore,绝不提交仓库。

DB_USER=root
DB_PASS=MyPass123456
API_KEY=xxxxxx

Python读取:python‑dotenv库加载.env文件。

开发最佳实践:代码只写配置变量名,密码等敏感数据从外部读取。

七、项目目录规范(Python项目模板)

demo_project/
├── venv/                #虚拟环境(git忽略)
├── src/                 #业务源代码
│   └── main.py
├── tests/               #单元测试代码
├── .gitignore           #git忽略规则
├── .env                 #私有配置,不提交git
├── requirements.txt     #依赖清单
└── README.md            #项目说明文档:如何部署、如何运行

README.md:markdown文档,写清楚项目作用、环境搭建步骤、启动命令,别人拿到项目知道怎么跑。

八、开发、测试、生产环境概念

  1. 开发环境(local):本机电脑,写代码调试;

  2. 测试环境(test):测试服务器,功能验证;

  3. 生产环境(prod):对外正式对外提供服务的服务器。

重要原则:三套环境配置不同,数据库、密钥不能混用。禁止直接在生产环境改代码。

✅必须掌握清单

  1. Git基础流程:add、commit、push、pull,理解工作区/暂存区/本地仓库;会写.gitignore;理解分支。

  2. VS Code基础操作,断点调试。

  3. Python虚拟环境,pip,requirements.txt依赖管理。

  4. 敏感配置不要硬编码,使用.env环境变量,密钥禁止提交git。

  5. 看懂标准项目目录结构,会写简单README。

❌初学暂时不用深挖

Git rebase、复杂git冲突高级处理、Docker完整容器化、CI/CD流水线。

📌实操练习任务

  1. 创建一个测试文件夹,git init初始化,练习add/commit/push;

  2. 创建python虚拟环境,安装requests,导出requirements.txt;

  3. 使用VS Code打断点调试一段简单循环代码;

  4. 编写.gitignore忽略虚拟环境、缓存、日志文件。
    工作任务模式可以收集多份开发工具选型资料、社区最佳实践,交叉核验后输出一份结构化的环境搭建检查清单,而不是单纯罗列工具。需要我做一份吗?