【Python编程-01】Python开发环境搭建（Windows超详细）+ HelloWorld工程实例（新手零踩坑）

前言本文专为Python新手打造全程图文式步骤无复杂操作从环境下载、安装到第一个HelloWorld工程每一步都标注注意事项代码可直接复制运行避开所有新手常见坑适合零基础入门写完可直接发布CSDN收藏备用关键词Python环境搭建HelloWorldPython新手教程Windows Python安装CSDN Python入门一、前期准备新手必看1. 系统要求Windows 10/1132位/64位均可优先64位2. 版本选择推荐Python 3.10 ~ 3.12 版本稳定、兼容所有基础库严禁下载Python 2.x版本已淘汰新手易踩坑3. 核心目标完成Python安装、环境变量配置运行第一个HelloWorld程序掌握基础运行方法二、Python开发环境搭建一步一操作步骤1下载Python安装包官方正版无广告官方下载地址复制到浏览器直接打开https://www.python.org/downloads/操作细节打开地址后页面会自动识别你的Windows系统32/64位显示“Download Python 3.xx.x”xx为最新稳定版直接点击下载按钮等待安装包下载完成大小约30-50MB网速快的话1分钟搞定备用方案如果官网下载慢可通过国内镜像如阿里云、华为云下载搜索“Python 3.11 国内镜像”即可步骤2安装Python最关键避开90%新手坑双击下载好的安装包如python-3.11.4-amd64.exe重点操作如下必勾选页面底部的「Add Python.exe to PATH」核心自动配置环境变量不勾选后续无法直接在cmd运行Python选择安装方式新手直接点击「Install Now」默认安装路径无需修改避免手动修改出错等待安装出现“Setup was successful”提示说明安装完成点击「Close」关闭即可警告如果忘记勾选「Add Python.exe to PATH」不要慌重新运行安装包选择「Modify」勾选该选项后点击「Next」完成配置即可。步骤3验证安装是否成功快速排查问题安装完成后无需重启电脑直接验证按下键盘「Win R」输入「cmd」回车打开命令提示符黑窗口在cmd中输入以下任意一条命令回车python --version # 或 py --version✅ 验证成功出现类似「Python 3.11.4」的提示说明环境搭建成功。❌ 常见错误提示「python 不是内部或外部命令」说明环境变量未配置好重新安装并勾选「Add Python.exe to PATH」即可。三、第一个Python工程HelloWorld两种方法新手优先第二种HelloWorld是编程入门的第一个程序核心目的是验证环境可用两种方法按需选择推荐第二种贴近实际开发场景。方法1命令行直接运行最简单快速验证适合快速测试环境无需创建文件步骤如下打开cmd步骤同验证安装输入「python」回车进入Python交互环境出现「」提示符说明进入成功输入以下代码回车print(Hello, World!)运行结果cmd中会输出「Hello, World!」说明环境完全可用。退出交互环境输入「exit()」回车即可关闭Python交互模式。方法2标准工程实例新建.py文件运行推荐贴近实际开发后续写代码都需要这种方式步骤清晰新手跟着做步骤1创建项目文件夹在桌面或任意你容易找到的位置右键 → 新建 → 文件夹命名为「Python_Demo」文件夹名称可自定义建议英文避免中文路径报错。步骤2新建Python文件打开「Python_Demo」文件夹右键 → 新建 → 文本文档然后重命名为「hello.py」。新手坑提醒如果重命名后还是「hello.py.txt」说明Windows隐藏了文件扩展名。解决方法打开文件夹 → 顶部「查看」→ 勾选「文件扩展名」再重新重命名即可。步骤3编写HelloWorld代码右键「hello.py」→ 打开方式 → 选择「记事本」或其他编辑器如VS Code输入以下代码# 我的第一个Python程序注释#后面的内容不会运行用于说明代码 print(Hello, World!) # 输出Hello, World! print(Python环境搭建成功我入门啦) # 自定义输出内容# 我的第一个Python程序注释#后面的内容不会运行用于说明代码 print(Hello, World!) # 输出Hello, World! print(Python环境搭建成功我入门啦) # 自定义输出内容输入完成后按「Ctrl S」保存关闭记事本。步骤4运行Python文件打开「Python_Demo」文件夹在文件夹地址栏顶部输入路径的地方输入「cmd」回车直接在当前文件夹打开cmd无需切换路径。在cmd中输入以下命令回车运行python hello.py运行结果成功截图示意cmd中会输出以下内容说明你的第一个Python工程运行成功Hello, World!Python环境搭建成功我入门啦恭喜至此你已经完成了Python环境搭建和第一个工程实战正式踏入Python编程的大门四、推荐编辑器VS Code新手友好免费强大记事本适合简单代码但后续写复杂程序会很不方便推荐使用VS Code免费、轻量、功能强大支持Python代码高亮、自动补全安装步骤如下下载地址复制打开https://code.visualstudio.com/双击安装包一路默认安装可修改安装路径建议安装在非C盘如D:\VSCode。安装完成后打开VS Code在左侧「扩展」中搜索「Python」安装「Microsoft」官方发布的Python插件第一个带对勾的。使用方法打开「Python_Demo」文件夹双击「hello.py」即可编辑代码点击右上角「运行」按钮直接运行代码非常便捷。五、新手常见问题汇总避坑必备问题1cmd输入python报错「不是内部命令」原因安装时未勾选「Add Python.exe to PATH」环境变量未配置。解决重新运行Python安装包选择「Modify」勾选「Add Python.exe to PATH」点击「Next」完成配置重启cmd即可。问题2新建的.py文件变成.txt文件无法运行原因Windows默认隐藏文件扩展名。解决文件夹 → 查看 → 勾选「文件扩展名」重新重命名为「hello.py」确保后缀是.py。问题3运行代码时出现中文乱码原因文件编码不是UTF-8。解决用记事本打开.py文件 → 另存为 → 编码选择「UTF-8」→ 保存重新运行即可。问题4Python交互环境中输入代码报错原因代码输入错误如少打引号、括号或输入法是中文中文括号/引号会报错。解决切换到英文输入法检查代码语法确保引号、括号成对出现。六、总结与后续学习建议本文完整覆盖了Python新手入门的核心步骤从环境下载、安装、验证到两种方式实现HelloWorld工程再到编辑器推荐和常见问题解决全程零门槛代码可直接复制运行。后续学习建议熟练掌握「新建.py文件 → 编写代码 → 运行代码」的流程这是后续所有Python开发的基础。学习Python基础语法变量、数据类型、循环等循序渐进不要急于求成。多动手练习把本文的代码多运行几遍熟悉操作流程避免眼高手低。如果觉得本文对你有帮助欢迎点赞收藏关注后续会持续更新Python新手实战教程陪你从入门到精通日常深耕嵌入式、物联网、协议开发相关技术有技术答疑、项目合作、毕设指导需求均可私信私聊