K8s 学习环境搭建:Python 与 PyCharm 开发环境配置指南
学习 Kubernetes 不只是敲 kubectl 命令,后续写 Operator、开发 Web 应用、管理 YAML 清单,都离不开 Python 和一款顺手的 IDE。PyCharm 是目前最流行的 Python IDE 之一,配合官方 Kubernetes 插件,写 YAML 时能获得语法高亮、字段提示和校验,效率直接上一个台阶。本文从零开始,带你完成 Python 与 PyCharm 的安装和配置。
一、Python 安装(Windows)
本步骤为后续 Python 开发做准备,如果电脑上已经装好 Python,可以跳过。
1. 下载安装包
打开 Python 官方网站 → 点击顶部 Downloads → 选择 Windows → 在 Stable Releases(稳定版)区域,点击 Python 3.14.x(x 为最新小版本)对应的 Download 按钮 → 选择 Windows installer (64-bit)(64 位系统,主流电脑均支持)。
2. 运行安装包
找到下载好的 python-3.14.x-amd64.exe,双击运行,然后注意关键一步:
- 勾选窗口底部的
Add Python 3.14 to PATH:让系统在任意位置都能调用 Python,必须勾选; - 点击
Install Now(默认安装,也可以选Customize installation自定义安装路径)。
3. 验证安装结果
按下 Win + R,输入 cmd 打开命令提示符,执行:
bash
python --version
注意是两个短横线。如果输出 Python 3.14.x,说明安装成功。
如果提示 python 不是内部或外部命令,说明安装时没有勾选 Add to PATH,需要重新运行安装包勾选该选项。
二、PyCharm 安装
版本怎么选
| 版本 | 费用 | 特点 | 适合人群 |
|---|---|---|---|
| Community(社区版) | 免费开源 | 支持 Python 核心开发功能 | 新手、日常开发 |
| Professional(专业版) | 付费 | 支持 Web 开发、数据库等高级功能 | 企业开发、全栈开发 |
安装步骤
- 访问 JetBrains 官网 → 点击
Download→ 选择Community版本 → 下载对应系统的安装包; - 运行安装包:勾选
Create Desktop Shortcut(创建桌面快捷方式)、Add launchers dir to PATH(可选)→ 点击Next→ 选择安装路径 → 点击Install。
关于激活
Professional 专业版是商业软件,请通过正规渠道获取授权:
- JetBrains 提供 30 天免费试用;
- 学生和教师可以通过官方申请免费教育授权(All Products Pack);
- 开源项目维护者也可以申请免费授权;
- 社区版本身完全免费,学习 Kubernetes 和基础 Python 开发完全够用。
不建议使用来源不明的破解工具,既有法律风险,也可能携带恶意代码。
三、设置中文语言
PyCharm 默认是英文界面,想换成中文很简单。
方法一:安装中文语言包插件
- 打开设置:菜单栏
File -> Settings...,或快捷键Ctrl + Alt + S; - 依次点击
Plugins -> Marketplace; - 搜索
Chinese,找到中文语言包(Chinese Language Pack / 中文简体语言包) ,点击Install安装; - 安装完成后重启 PyCharm,界面即变为中文。
方法二:手动设置语言
如果重启后还是英文,需要手动指定语言:
- 再次打开设置:
File -> Settings...或Ctrl + Alt + S; - 进入
Appearance & Behavior -> System Settings -> Language and Region; - 在语言列表中选择简体中文;
- 重启 PyCharm 即可。
四、配置项目与 Python 环境
1. 创建新项目
打开 PyCharm,在欢迎界面点击新建项目 ,也可以通过菜单 文件 -> 新建项目。
创建时配置以下选项:
- 位置 :选择项目保存路径。路径中不要包含中文和空格,避免后续工具链出现编码或路径问题;
- 创建欢迎脚本:可以不勾选(可选);
- 解释器类型 :选择项目 venv(虚拟环境)。PyCharm 会自动为当前项目创建独立的 Python 虚拟环境,每个项目的依赖互不干扰,这是官方推荐的实践。
点击创建后,可以在右下角看到 PyCharm 正在执行项目环境创建任务,等待完成即可。
2. 验证环境配置
创建完成后,PyCharm 的右下角会显示当前项目使用的 Python 环境 ,例如 Python 3.14。看到这个信息,说明项目虚拟环境配置成功。
五、安装 Kubernetes 插件
编写 K8s YAML 清单时,官方 Kubernetes 插件可以提供字段自动补全、语法检查和文档提示,强烈推荐安装。
方式一:插件市场安装
- 打开 PyCharm,依次点击菜单:
文件 -> 设置 -> 插件; - 切换到
Marketplace标签; - 搜索 Kubernetes(JetBrains 官方出品);
- 点击安装 ,安装完成后重启 IDE 生效。
方式二:从磁盘安装(离线兜底)
如果插件市场安装失败(比如网络原因提示下载失败),可以从官网手动下载插件包并导入:
- 访问 JetBrains 插件官网,搜索 Kubernetes,选择匹配自己 PyCharm 版本的插件包(zip 文件);
- 打开 PyCharm 的插件安装界面,点击右上角齿轮图标 ,选择从磁盘安装插件;
- 选择下载好的插件文件,点击安装;
- 安装成功后,在已安装标签下可以看到 Kubernetes 插件,重启 IDE 后即可使用。
总结
一套完整的 K8s 学习开发环境包括三部分:
- Python :勾选
Add to PATH,装完用python --version验证; - PyCharm:新手选社区版就够,装好中文语言包,用 venv 创建隔离的项目环境;
- Kubernetes 插件:从 Marketplace 安装,失败时用官网插件包从磁盘安装。
环境搭好之后,无论是写 Python 脚本、调试代码,还是编辑 K8s 资源清单,都会顺手很多。下一篇文章,就可以正式进入 Kubernetes 的世界了。