news 2026/4/28 3:58:25

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

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
【Python编程-01】Python开发环境搭建(Windows超详细)+ HelloWorld工程实例(新手零踩坑)

前言:本文专为Python新手打造,全程图文式步骤(无复杂操作),从环境下载、安装到第一个HelloWorld工程,每一步都标注注意事项,代码可直接复制运行,避开所有新手常见坑,适合零基础入门,写完可直接发布CSDN,收藏备用!

关键词:Python环境搭建;HelloWorld;Python新手教程;Windows Python安装;CSDN Python入门

一、前期准备(新手必看)

1. 系统要求:Windows 10/11(32位/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),重点操作如下:

  1. 必勾选:页面底部的「Add Python.exe to PATH」(核心!自动配置环境变量,不勾选后续无法直接在cmd运行Python)

  2. 选择安装方式:新手直接点击「Install Now」(默认安装,路径无需修改,避免手动修改出错)

  3. 等待安装:出现“Setup was successful”提示,说明安装完成,点击「Close」关闭即可

警告:如果忘记勾选「Add Python.exe to PATH」,不要慌!重新运行安装包,选择「Modify」,勾选该选项后,点击「Next」完成配置即可。

步骤3:验证安装是否成功(快速排查问题)

安装完成后,无需重启电脑,直接验证:

  1. 按下键盘「Win + R」,输入「cmd」,回车打开命令提示符(黑窗口)

  2. 在cmd中输入以下任意一条命令,回车:

python --version # 或 py --version

✅ 验证成功:出现类似「Python 3.11.4」的提示,说明环境搭建成功。

❌ 常见错误:提示「'python' 不是内部或外部命令」,说明环境变量未配置好,重新安装并勾选「Add Python.exe to PATH」即可。

三、第一个Python工程:HelloWorld(两种方法,新手优先第二种)

HelloWorld是编程入门的第一个程序,核心目的是验证环境可用,两种方法按需选择,推荐第二种(贴近实际开发场景)。

方法1:命令行直接运行(最简单,快速验证)

适合快速测试环境,无需创建文件,步骤如下:

  1. 打开cmd(步骤同验证安装),输入「python」,回车进入Python交互环境(出现「>>>」提示符,说明进入成功)

  2. 输入以下代码,回车:

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文件

  1. 打开「Python_Demo」文件夹,在文件夹地址栏(顶部输入路径的地方)输入「cmd」,回车(直接在当前文件夹打开cmd,无需切换路径)。

  2. 在cmd中输入以下命令,回车运行:

python hello.py

运行结果(成功截图示意)

cmd中会输出以下内容,说明你的第一个Python工程运行成功!

Hello, World!

Python环境搭建成功,我入门啦!

恭喜!至此,你已经完成了Python环境搭建和第一个工程实战,正式踏入Python编程的大门!

四、推荐编辑器:VS Code(新手友好,免费强大)

记事本适合简单代码,但后续写复杂程序会很不方便,推荐使用VS Code(免费、轻量、功能强大,支持Python代码高亮、自动补全),安装步骤如下:

  1. 下载地址(复制打开):https://code.visualstudio.com/

  2. 双击安装包,一路默认安装(可修改安装路径,建议安装在非C盘,如D:\VSCode)。

  3. 安装完成后,打开VS Code,在左侧「扩展」中搜索「Python」,安装「Microsoft」官方发布的Python插件(第一个,带对勾的)。

  4. 使用方法:打开「Python_Demo」文件夹,双击「hello.py」,即可编辑代码,点击右上角「运行」按钮,直接运行代码,非常便捷。

五、新手常见问题汇总(避坑必备)

问题1:cmd输入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」→ 保存,重新运行即可。

问题4:Python交互环境中,输入代码报错

原因:代码输入错误(如少打引号、括号),或输入法是中文(中文括号/引号会报错)。

解决:切换到英文输入法,检查代码语法,确保引号、括号成对出现。

六、总结与后续学习建议

本文完整覆盖了Python新手入门的核心步骤:从环境下载、安装、验证,到两种方式实现HelloWorld工程,再到编辑器推荐和常见问题解决,全程零门槛,代码可直接复制运行。

后续学习建议:

  • 熟练掌握「新建.py文件 → 编写代码 → 运行代码」的流程,这是后续所有Python开发的基础。

  • 学习Python基础语法(变量、数据类型、循环等),循序渐进,不要急于求成。

  • 多动手练习,把本文的代码多运行几遍,熟悉操作流程,避免眼高手低。


如果觉得本文对你有帮助,欢迎点赞+收藏+关注,后续会持续更新Python新手实战教程,陪你从入门到精通!

日常深耕嵌入式、物联网、协议开发相关技术,有技术答疑、项目合作、毕设指导需求,均可私信私聊!


版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/4/28 3:57:06

Arm架构数据缓存指令解析与应用实践

1. Arm架构数据缓存指令概述在Armv8/v9架构中,数据缓存(Data Cache)是处理器内存层次结构中的关键组件,用于减少CPU访问主存的延迟。现代Arm处理器通常采用多级缓存设计,其中L1数据缓存(通常32-64KB&#x…

作者头像 李华
网站建设 2026/4/28 3:46:34

CUDA应用检查点技术:透明化GPU状态保存与恢复

1. CUDA应用检查点技术解析在HPC和科学计算领域,GPU加速应用通常需要长时间运行,如何实现这类应用的状态保存与恢复一直是技术难点。传统解决方案要么需要应用层显式实现状态保存逻辑(开发成本高),要么依赖虚拟机级别的…

作者头像 李华
网站建设 2026/4/28 3:44:01

嵌入式设备意外射频接收:空气隔离安全的新挑战

1. 嵌入式设备意外射频接收现象解析 在关键基础设施和工业控制系统中,空气隔离(Airgap)技术长期以来被视为物理隔离防护的终极手段。然而,最近的研究揭示了一个令人不安的事实:即使没有任何无线通信硬件或专用传感器&a…

作者头像 李华
网站建设 2026/4/28 3:43:55

经典排序算法总结(包括快速排序,堆排序)

1. 直接插入排序核心思路将数组分为「已排序区」和「未排序区」,初始时已排序区只有第一个元素。依次取出未排序区的第一个元素,从已排序区末尾向前遍历,找到第一个小于等于该元素的位置,将其插入,直到所有元素排序完成…

作者头像 李华