1. 从“Hello World”到第一个项目为什么是PyCharm如果你刚刚接触Python或者正准备开始学习那么“如何运行第一个Python程序”就是你遇到的第一个也是最关键的一个坎。你可能已经尝试过在记事本里写代码然后用命令行去运行结果不是路径不对就是环境变量没配好一个简单的print(“Hello World”)都跑不起来挫败感瞬间拉满。或者你可能听说过一些轻量级的编辑器比如VS Code、Sublime Text但面对一堆需要自己配置的插件和终端又觉得无从下手。这正是我推荐新手尤其是零基础的小白直接从PyCharm开始的原因。它不是“最好”的编辑器但绝对是“最适合入门”的集成开发环境IDE。你可以把它理解为一个为你量身定做的“编程工作站”。当你打开PyCharm创建一个新项目时它已经帮你自动处理好了最让人头疼的几件事Python解释器的配置、项目目录结构的管理、代码的智能提示和错误检查。你不用再关心“我的python命令在哪里”、“这个脚本该放在哪个文件夹”这类问题可以立刻把全部精力投入到“写代码”这件事本身。很多新手教程会告诉你“先装Python再配环境变量然后用命令行...”。这个流程没错但它把最枯燥、最容易出错的部分放在了最前面很容易劝退。而PyCharm的思路是“先让你跑起来感受到编程的乐趣和即时反馈再慢慢了解背后的原理”。当你点击那个绿色的“运行”按钮看到控制台成功输出结果时那种成就感是驱动你继续学习的最佳燃料。所以这篇教程的目标非常明确手把手带你绕过所有初学者的坑用最短的时间、最少的困惑在PyCharm里成功运行你的第一个Python程序并理解这背后每一步的意义。2. 环境搭建下载、安装与首次启动的完整指南万事开头难而安装往往是第一个难关。网上教程众多但信息碎片化容易让人在版本选择、安装选项上犯迷糊。这里我会为你梳理一条最清晰、最稳妥的路径。2.1 核心前置Python解释器的安装与验证PyCharm本身只是一个“编辑器”和“管理工具”真正执行你代码的是Python解释器。所以在安装PyCharm之前或之后你必须确保系统里有一个可用的Python。第一步下载Python直接访问Python官网python.org点击“Downloads”选项卡。对于Windows用户官网通常会直接推荐最新稳定版比如Python 3.12.x。我强烈建议新手选择这个最新稳定版而不是纠结于某个旧版本。新版本有更好的性能、更多的特性并且绝大多数教程和库都已兼容。第二步安装PythonWindows重点运行下载好的安装程序你会看到一个非常重要的界面“Install launcher for all users”和“Add Python 3.x to PATH”。这里有一个必须勾选的选项Add Python 3.x to PATH。这是什么PATH是系统寻找可执行文件的路径列表。勾选它意味着你可以在任何位置的命令行CMD或PowerShell里直接输入python或pip来启动Python或包管理工具而不需要输入完整的安装路径。为什么必须勾选如果不勾选后续在PyCharm外使用命令行安装第三方库如pip install requests会非常麻烦你需要手动配置环境变量。对于新手勾选它是避免后续无数麻烦的最简单方法。其他选项建议使用“Install Now”默认安装路径或者选择“Customize installation”并确保勾选“pip”和“for all users”选项。安装目录避免使用中文或带空格的路径比如C:\Python312\就很好。第三步验证安装安装完成后按下Win R输入cmd打开命令提示符然后输入python --version如果正确显示Python 3.x.x恭喜你Python环境安装成功。同时输入pip --version也应能显示pip的版本信息。这一步验证至关重要它能确保你的基础环境是健康的。2.2 PyCharm的选型与安装社区版足矣JetBrains公司为PyCharm提供了两个版本专业版Professional和社区版Community。对于纯Python学习和开发社区版完全免费且功能足够强大。它包含了代码高亮、智能补全、调试器、版本控制集成Git、科学计算模式等所有核心功能。专业版主要额外支持Web开发框架如Django, Flask、数据库工具、远程开发等高级功能初学者短期内用不到。安装过程访问JetBrains官网找到PyCharm下载页面选择“Community”版本下载。运行安装程序基本上一路“Next”即可。在“Installation Options”界面我建议进行以下勾选Create Desktop Shortcut创建桌面快捷方式方便启动。Update PATH variable将PyCharm启动命令添加到系统PATH。这样以后你可以在命令行直接用pycharm命令打开项目非常方便。Update Context Menu添加“Open Folder as Project”到右键菜单。之后你可以在任何文件夹上右键直接用PyCharm将其作为项目打开。Create Associations关联.py文件。勾选后双击.py文件默认会用PyCharm打开而不是记事本。选择安装路径同样建议使用英文无空格路径如C:\Program Files\JetBrains\PyCharm Community Edition。安装完成后首次启动PyCharm可能会让你选择主题深色Darcula或浅色Light和键盘映射方案保持默认即可。这些都可以后续在设置中更改。3. 创建你的第一个PyCharm项目不仅仅是新建文件很多新手会把“在PyCharm里写代码”等同于“新建一个.py文件”。这没错但忽略了“项目Project”这个概念的重要性。在PyCharm中项目是一个独立的、包含所有源代码、资源、配置和虚拟环境的工作空间。正确创建项目是后续一切顺利的基础。3.1 新建项目理解关键配置项启动PyCharm你会看到欢迎界面点击“New Project”。接下来这个配置窗口包含了几个关键点Location位置为你项目选择一个“干净”的文件夹。例如D:\MyPythonProjects\first_project。强烈建议为你的所有Python项目建立一个专属目录而不是随意放在桌面或文档里这有利于长期管理。Project Type项目类型保持默认的“Pure Python”即可。Python InterpreterPython解释器这是核心配置New environment usingPyCharm建议你为这个新项目创建一个“虚拟环境Virtual Environment”。这是一个极其重要且推荐的做法。虚拟环境相当于为这个项目单独开辟一个干净的Python沙箱里面安装的第三方库如numpy, pandas只对本项目有效不会影响系统全局的Python环境或其他项目。这能完美解决“库版本冲突”这个未来一定会遇到的噩梦级问题。Location虚拟环境会创建在你项目目录下的一个子文件夹里如venv无需手动修改。Base interpreter这里应该自动检测到你之前安装的系统Python解释器如C:\Python312\python.exe。如果没显示点击下拉框右侧的“...”手动定位到你的python.exe文件。Create a main.py welcome script这个选项默认勾选。我建议取消勾选。因为我们要从零开始创建自己的第一个程序而不是修改现成的模板这样理解更深刻。配置完成后点击“Create”。PyCharm会花一点时间创建项目目录和虚拟环境。完成后你就进入了PyCharm的主界面。3.2 认识PyCharm工作界面找到你的“武器”第一次看到PyCharm的界面可能会觉得有些复杂但我们需要关注的只有几个核心区域左侧的“Project”窗口这里以树状结构展示你项目中的所有文件和文件夹。你的代码文件就在这里管理。中间的大片编辑区你编写代码的地方。下方的“Run”或“Terminal”窗口程序运行后的输出会显示在这里。旁边的“Terminal”标签页则是一个内置的命令行终端它自动激活了当前项目的虚拟环境。你在这里输入pip install命令库就会安装到本项目独有的虚拟环境中不会污染系统。右侧边栏通常会有数据库、运行/调试配置等工具初期可以暂时忽略。现在在左侧“Project”窗口里右键点击你的项目根目录就是first_project那个文件夹选择New - Python File。给你的第一个文件起个名字比如hello.py。注意.py扩展名是必须的。双击这个新创建的hello.py文件它就会在中间的编辑区打开等待你输入代码。4. 编写、运行与调试完成第一个闭环环境有了项目建了文件也创建了终于到了最激动人心的环节让代码跑起来。4.1 编写第一行有效代码在hello.py文件中输入以下代码print(Hello, PyCharm World!)就是这么简单。print()是Python最基本的内置函数之一它的作用就是把括号里的内容输出到控制台。注意引号必须是英文的或这是大多数编程语言的通用规则。PyCharm的智能提示Code Completion功能此时应该已经发挥作用了。当你输入pri的时候它可能会弹出一个下拉框提示print你可以按Tab或Enter键自动补全。这是一个能极大提升编码效率的功能请慢慢习惯并依赖它。4.2 多种运行方式及其应用场景如何运行这段代码PyCharm提供了多种方式适用于不同场景最直接的方式推荐新手在代码编辑区域内任意位置右键点击选择“Run ‘hello’”。这是运行当前文件最快捷的方法。使用快捷键选中该文件或在编辑区内按下Shift F10Windows/Linux或Ctrl RmacOS。这是最常用的运行快捷键。使用顶部工具栏点击工具栏上一个绿色的“播放”按钮▶旁边通常显示“hello”。点击它旁边的下拉箭头可以管理不同的运行配置。在项目视图中运行在左侧项目树中右键点击hello.py文件选择“Run ‘hello’”。无论使用哪种方式你都会看到PyCharm底部的“Run”工具窗口自动弹出并显示类似以下的输出C:\Users\YourName\PycharmProjects\first_project\venv\Scripts\python.exe D:/MyPythonProjects/first_project/hello.py Hello, PyCharm World! Process finished with exit code 0第一行显示了PyCharm调用的是你项目虚拟环境中的Python解释器venv\Scripts\python.exe来执行你的脚本文件。第二行就是程序的输出。最后一行“exit code 0”表示程序正常结束没有错误。注意如果你看到错误提示比如“ModuleNotFoundError”或者关于解释器的错误请回到第3.1节检查创建项目时是否正确配置了Python解释器并确认是在当前项目窗口中运行。4.3 初探调试让程序“慢动作”执行运行只能看到结果而调试Debug可以让你看到程序一步步执行的过程是定位和解决复杂问题的神器。对于print(“Hello World”)这样的单行程序调试显得杀鸡用牛刀但你必须知道这个功能在哪里以及基本操作。设置断点Breakpoint在你代码行号的左侧灰色区域点击一下会出现一个红色圆点。这表示一个断点程序执行到这里时会暂停。开始调试右键点击代码区域选择“Debug ‘hello’”或者使用快捷键Shift F9。观察与步进程序启动后会在断点处暂停。此时“Debug”工具窗口会打开显示当前所有变量的值目前还没有。你可以使用工具栏上的按钮控制执行Step Over (F8)执行当前行如果当前行是一个函数调用不会进入函数内部直接得到函数结果并跳到下一行。Step Into (F7)执行当前行如果当前行是一个函数调用会进入该函数的内部。对于print()这样的内置函数按F7可能会跳转到底层实现新手暂时可以不用。Resume Program (F9)从当前暂停处继续运行直到下一个断点或程序结束。尝试在print那一行设置断点然后调试。你会发现程序在输出之前就停住了。按下F8Step Over你会看到输出出现在控制台并且程序结束。这就是调试的基本流程。未来当你的程序逻辑复杂、出现意想不到的结果时通过设置断点和步进你可以像侦探一样查看每一步执行后变量的变化从而找到bug所在。5. 超越“Hello World”项目实战与常见问题排雷成功运行第一个程序只是起点。接下来我们要在这个项目中做一些更实际的事情并预演你接下来肯定会遇到的几个典型问题。5.1 实战编写一个简易的交互式程序让我们把hello.py的内容替换成一个更有趣的小程序# 这是一个简单的用户信息收集程序 user_name input(请输入你的名字 ) user_age input(请输入你的年龄 ) # 注意input()获取的都是字符串str如果需要数字计算需要用int()或float()转换 # user_age_int int(user_age) print(f\n你好{user_name}) # 使用f-string格式化字符串这是Python 3.6的推荐写法 print(f明年你就{int(user_age) 1}岁了。) # 这里进行了类型转换和计算 # 一个简单的判断 if int(user_age) 18: print(你已经是成年人了。) else: print(你还是个未成年人。)这个程序用到了几个新概念变量 (user_name,user_age)用来存储数据。input()函数在控制台等待用户输入并将输入内容作为字符串返回。f-string格式化在字符串前加f可以在字符串内用{变量名}直接嵌入变量值非常方便。类型转换 (int(user_age))将字符串user_age转换为整数才能进行数学运算1。if-else判断根据条件执行不同的代码块。运行这个程序根据提示输入名字和年龄观察输出。你已经在写一个有点“智能”的程序了5.2 高频问题排雷与解决思路在你接下来的学习过程中几乎一定会遇到下面这些问题。提前了解可以让你在遇到时不再慌张。问题一运行时报错ModuleNotFoundError: No module named ‘xxx’场景当你尝试使用第三方库如requests,numpy或者从别处复制了一段代码过来运行时。原因你需要的库没有安装在当前项目使用的Python环境中。解决方案确保PyCharm底部Terminal标签页处于激活状态它会显示(venv)前缀。在Terminal中输入pip install xxx将xxx替换为库名如pip install requests。等待安装完成重新运行程序。为什么这么做因为我们创建项目时使用了虚拟环境venvpip install命令必须在这个环境的终端里执行库才会安装到本项目目录下的venv文件夹里。如果你在系统自带的CMD里安装PyCharm项目是找不到的。问题二PyCharm代码有红色波浪线提示“Unresolved reference”场景你明明安装了库或者导入了模块但PyCharm仍然在代码中标记错误。原因PyCharm的智能感知没有正确索引到当前解释器环境中的库。解决方案检查PyCharm右下角确认当前选择的解释器是你项目的虚拟环境如Python 3.12 (first_project-venv)。如果解释器正确可以尝试点击PyCharm顶部菜单File - Invalidate Caches...然后选择“Invalidate and Restart”。这会清除PyCharm的缓存并重启通常能解决索引问题。对于自己编写的其他.py文件确保它们在同一项目目录下并且使用正确的导入语句如from my_module import my_function。问题三代码运行没报错但结果不对或没输出场景程序正常跑完exit code 0但控制台没有预期的打印结果或者计算结果错误。排查思路检查运行的是否是目标文件有时你可能打开了多个文件PyCharm运行的是上一次的配置。确保编辑区焦点在你要运行的文件上或者去顶部工具栏的下拉菜单确认运行配置指向正确的文件。使用print进行调试在怀疑有问题的代码段前后多添加几个print语句输出关键变量的值。这是最朴素也是最有效的调试手段。例如print(f”变量a的值是{a}”)。检查逻辑错误特别是条件判断if和循环for,while的边界条件。比如if age 18:和if age 18:的结果就不同。检查缩进Python用缩进来定义代码块。如果if下面的print语句缩进不对它就不会被当作if的一部分执行。PyCharm通常会自动处理缩进但如果你从网页复制代码可能会引入制表符Tab和空格混用的问题。在PyCharm中你可以看到缩进线确保它们对齐。问题四如何安装旧版本的库场景教程里要求安装numpy1.21.0但你直接pip install numpy装的是最新版。解决方案在Terminal中使用pip install numpy1.21.0。pip允许通过,,等符号指定版本。进阶管理当项目依赖很多库时可以使用pip freeze requirements.txt命令将当前环境的所有库及版本导出到一个文件中。换到新电脑或新环境时只需运行pip install -r requirements.txt就能一键安装所有依赖。这是Python项目协作和部署的通用做法。6. 高效使用PyCharm提升编码速度的必备技巧当你熟悉了基本流程后掌握一些PyCharm的高效操作能让你的学习和开发事半功倍。6.1 代码编辑与导航技巧智能补全 (Ctrl Space)这是你最好的朋友。输入部分字符后按CtrlSpacePyCharm会给出变量名、函数名、模块名等建议。即使你不记得全名它也能根据上下文猜出来。快速查看文档 (Ctrl Q)将光标放在一个函数如print或库名上按CtrlQ会弹出一个窗口显示该对象的简要文档Docstring不用离开编辑器就能了解用法。快速跳转到定义 (Ctrl 鼠标左键 / CtrlB)想知道一个函数或变量在哪里定义的按住Ctrl键用鼠标点击它或者把光标放上去按CtrlBPyCharm会直接打开定义它的文件并定位到那一行。对于阅读和理解他人代码或自己很久以前写的代码极其有用。重命名重构 (Shift F6)选中一个变量或函数名按ShiftF6可以重命名它。PyCharm会智能地更新项目中所有引用到这个名字的地方避免手动修改遗漏导致的错误。快速复制/移动行 (CtrlD / CtrlShift上下箭头)不需要选中光标放在某一行按CtrlD可以复制该行。按CtrlShift上/下箭头可以将该行上下移动。6.2 运行/调试配置的深入理解你可能会注意到每次运行后PyCharm顶部工具栏的下拉菜单里会保存一个“hello”的运行配置。你可以点击它旁边的“Edit Configurations”进行详细设置。脚本路径 (Script path)指定要运行的Python文件。参数 (Parameters)可以在这里输入命令行参数。比如你的脚本需要处理一个文件名你可以在这里输入data.txt然后在代码中用sys.argv来获取这个参数。工作目录 (Working directory)程序运行时认为的“当前目录”。默认是你的项目根目录。这会影响像open(‘file.txt’)这种使用相对路径的文件操作。Python解释器 (Python interpreter)确保这里选中的是你项目的虚拟环境解释器。对于简单的单文件脚本通常不需要修改这些。但当你开始编写更复杂的、需要参数或特定环境变量的程序时这里就是配置入口。6.3 版本控制入门用Git管理你的代码即使是一个人学习我也强烈建议你尽早接触Git。它就像写代码的“后悔药”和“时光机”。PyCharm集成了出色的Git支持。初始化Git仓库在PyCharm顶部菜单选择VCS - Enable Version Control Integration...然后选择“Git”。这会在你的项目根目录创建一个隐藏的.git文件夹。提交 (Commit) 代码当你写完一个功能或修复一个bug后点击PyCharm左侧的“Commit”工具按钮通常是一个绿色的对勾√。你会看到一个窗口列出了所有被修改的文件。在上方的输入框里简要描述你这次做了什么例如“添加了用户输入和年龄判断功能”然后点击“Commit”。这相当于给你的代码当前状态拍了一张快照。查看历史与回退在“Commit”工具窗口你可以看到所有的提交历史。如果你新写的代码把程序搞坏了你可以轻松地回退到任何一个之前的“快照”状态。使用Git你再也不用为了保留“能运行的版本”而不断复制整个项目文件夹了。这是专业开发者的标配技能越早养成习惯越好。走到这里你已经完成了从零开始在PyCharm中安装、配置、编写、运行、调试Python程序的全过程。你不仅知道了怎么点击按钮更理解了每一步背后的意义和可能遇到的坑。编程学习是一个不断遇到问题、解决问题的循环。PyCharm是你强大的助手但它不能替代你的思考和实践。接下来最好的行动就是关闭这篇教程打开PyCharm开始尝试修改hello.py里的代码比如让程序计算两个数的和或者根据输入的成绩输出等级。每一次成功的运行和每一个被解决的错误都会让你离“Python开发者”这个身份更近一步。记住所有复杂的项目都是从一行简单的print(“Hello World”)开始的。 1. 从“Hello World”到第一个项目为什么是PyCharm如果你刚刚接触Python或者正准备开始学习那么“如何运行第一个Python程序”就是你遇到的第一个也是最关键的一个坎。你可能已经尝试过在记事本里写代码然后用命令行去运行结果不是路径不对就是环境变量没配好一个简单的print(“Hello World”)都跑不起来挫败感瞬间拉满。或者你可能听说过一些轻量级的编辑器比如VS Code、Sublime Text但面对一堆需要自己配置的插件和终端又觉得无从下手。这正是我推荐新手尤其是零基础的小白直接从PyCharm开始的原因。它不是“最好”的编辑器但绝对是“最适合入门”的集成开发环境IDE。你可以把它理解为一个为你量身定做的“编程工作站”。当你打开PyCharm创建一个新项目时它已经帮你自动处理好了最让人头疼的几件事Python解释器的配置、项目目录结构的管理、代码的智能提示和错误检查。你不用再关心“我的python命令在哪里”、“这个脚本该放在哪个文件夹”这类问题可以立刻把全部精力投入到“写代码”这件事本身。很多新手教程会告诉你“先装Python再配环境变量然后用命令行...”。这个流程没错但它把最枯燥、最容易出错的部分放在了最前面很容易劝退。而PyCharm的思路是“先让你跑起来感受到编程的乐趣和即时反馈再慢慢了解背后的原理”。当你点击那个绿色的“运行”按钮看到控制台成功输出结果时那种成就感是驱动你继续学习的最佳燃料。所以这篇教程的目标非常明确手把手带你绕过所有初学者的坑用最短的时间、最少的困惑在PyCharm里成功运行你的第一个Python程序并理解这背后每一步的意义。2. 环境搭建下载、安装与首次启动的完整指南万事开头难而安装往往是第一个难关。网上教程众多但信息碎片化容易让人在版本选择、安装选项上犯迷糊。这里我会为你梳理一条最清晰、最稳妥的路径。2.1 核心前置Python解释器的安装与验证PyCharm本身只是一个“编辑器”和“管理工具”真正执行你代码的是Python解释器。所以在安装PyCharm之前或之后你必须确保系统里有一个可用的Python。第一步下载Python直接访问Python官网python.org点击“Downloads”选项卡。对于Windows用户官网通常会直接推荐最新稳定版比如Python 3.12.x。我强烈建议新手选择这个最新稳定版而不是纠结于某个旧版本。新版本有更好的性能、更多的特性并且绝大多数教程和库都已兼容。第二步安装PythonWindows重点运行下载好的安装程序你会看到一个非常重要的界面“Install launcher for all users”和“Add Python 3.x to PATH”。这里有一个必须勾选的选项Add Python 3.x to PATH。这是什么PATH是系统寻找可执行文件的路径列表。勾选它意味着你可以在任何位置的命令行CMD或PowerShell里直接输入python或pip来启动Python或包管理工具而不需要输入完整的安装路径。为什么必须勾选如果不勾选后续在PyCharm外使用命令行安装第三方库如pip install requests会非常麻烦你需要手动配置环境变量。对于新手勾选它是避免后续无数麻烦的最简单方法。其他选项建议使用“Install Now”默认安装路径或者选择“Customize installation”并确保勾选“pip”和“for all users”选项。安装目录避免使用中文或带空格的路径比如C:\Python312\就很好。第三步验证安装安装完成后按下Win R输入cmd打开命令提示符然后输入python --version如果正确显示Python 3.x.x恭喜你Python环境安装成功。同时输入pip --version也应能显示pip的版本信息。这一步验证至关重要它能确保你的基础环境是健康的。2.2 PyCharm的选型与安装社区版足矣JetBrains公司为PyCharm提供了两个版本专业版Professional和社区版Community。对于纯Python学习和开发社区版完全免费且功能足够强大。它包含了代码高亮、智能补全、调试器、版本控制集成Git、科学计算模式等所有核心功能。专业版主要额外支持Web开发框架如Django, Flask、数据库工具、远程开发等高级功能初学者短期内用不到。安装过程访问JetBrains官网找到PyCharm下载页面选择“Community”版本下载。运行安装程序基本上一路“Next”即可。在“Installation Options”界面我建议进行以下勾选Create Desktop Shortcut创建桌面快捷方式方便启动。Update PATH variable将PyCharm启动命令添加到系统PATH。这样以后你可以在命令行直接用pycharm命令打开项目非常方便。Update Context Menu添加“Open Folder as Project”到右键菜单。之后你可以在任何文件夹上右键直接用PyCharm将其作为项目打开。Create Associations关联.py文件。勾选后双击.py文件默认会用PyCharm打开而不是记事本。选择安装路径同样建议使用英文无空格路径如C:\Program Files\JetBrains\PyCharm Community Edition。安装完成后首次启动PyCharm可能会让你选择主题深色Darcula或浅色Light和键盘映射方案保持默认即可。这些都可以后续在设置中更改。3. 创建你的第一个PyCharm项目不仅仅是新建文件很多新手会把“在PyCharm里写代码”等同于“新建一个.py文件”。这没错但忽略了“项目Project”这个概念的重要性。在PyCharm中项目是一个独立的、包含所有源代码、资源、配置和虚拟环境的工作空间。正确创建项目是后续一切顺利的基础。3.1 新建项目理解关键配置项启动PyCharm你会看到欢迎界面点击“New Project”。接下来这个配置窗口包含了几个关键点Location位置为你项目选择一个“干净”的文件夹。例如D:\MyPythonProjects\first_project。强烈建议为你的所有Python项目建立一个专属目录而不是随意放在桌面或文档里这有利于长期管理。Project Type项目类型保持默认的“Pure Python”即可。Python InterpreterPython解释器这是核心配置New environment usingPyCharm建议你为这个新项目创建一个“虚拟环境Virtual Environment”。这是一个极其重要且推荐的做法。虚拟环境相当于为这个项目单独开辟一个干净的Python沙箱里面安装的第三方库如numpy, pandas只对本项目有效不会影响系统全局的Python环境或其他项目。这能完美解决“库版本冲突”这个未来一定会遇到的噩梦级问题。Location虚拟环境会创建在你项目目录下的一个子文件夹里如venv无需手动修改。Base interpreter这里应该自动检测到你之前安装的系统Python解释器如C:\Python312\python.exe。如果没显示点击下拉框右侧的“...”手动定位到你的python.exe文件。Create a main.py welcome script这个选项默认勾选。我建议取消勾选。因为我们要从零开始创建自己的第一个程序而不是修改现成的模板这样理解更深刻。配置完成后点击“Create”。PyCharm会花一点时间创建项目目录和虚拟环境。完成后你就进入了PyCharm的主界面。3.2 认识PyCharm工作界面找到你的“武器”第一次看到PyCharm的界面可能会觉得有些复杂但我们需要关注的只有几个核心区域左侧的“Project”窗口这里以树状结构展示你项目中的所有文件和文件夹。你的代码文件就在这里管理。中间的大片编辑区你编写代码的地方。下方的“Run”或“Terminal”窗口程序运行后的输出会显示在这里。旁边的“Terminal”标签页则是一个内置的命令行终端它自动激活了当前项目的虚拟环境。你在这里输入pip install命令库就会安装到本项目独有的虚拟环境中不会污染系统。右侧边栏通常会有数据库、运行/调试配置等工具初期可以暂时忽略。现在在左侧“Project”窗口里右键点击你的项目根目录就是first_project那个文件夹选择New - Python File。给你的第一个文件起个名字比如hello.py。注意.py扩展名是必须的。双击这个新创建的hello.py文件它就会在中间的编辑区打开等待你输入代码。4. 编写、运行与调试完成第一个闭环环境有了项目建了文件也创建了终于到了最激动人心的环节让代码跑起来。4.1 编写第一行有效代码在hello.py文件中输入以下代码print(Hello, PyCharm World!)就是这么简单。print()是Python最基本的内置函数之一它的作用就是把括号里的内容输出到控制台。注意引号必须是英文的或这是大多数编程语言的通用规则。PyCharm的智能提示Code Completion功能此时应该已经发挥作用了。当你输入pri的时候它可能会弹出一个下拉框提示print你可以按Tab或Enter键自动补全。这是一个能极大提升编码效率的功能请慢慢习惯并依赖它。4.2 多种运行方式及其应用场景如何运行这段代码PyCharm提供了多种方式适用于不同场景最直接的方式推荐新手在代码编辑区域内任意位置右键点击选择“Run ‘hello’”。这是运行当前文件最快捷的方法。使用快捷键选中该文件或在编辑区内按下Shift F10Windows/Linux或Ctrl RmacOS。这是最常用的运行快捷键。使用顶部工具栏点击工具栏上一个绿色的“播放”按钮▶旁边通常显示“hello”。点击它旁边的下拉箭头可以管理不同的运行配置。在项目视图中运行在左侧项目树中右键点击hello.py文件选择“Run ‘hello’”。无论使用哪种方式你都会看到PyCharm底部的“Run”工具窗口自动弹出并显示类似以下的输出C:\Users\YourName\PycharmProjects\first_project\venv\Scripts\python.exe D:/MyPythonProjects/first_project/hello.py Hello, PyCharm World! Process finished with exit code 0第一行显示了PyCharm调用的是你项目虚拟环境中的Python解释器venv\Scripts\python.exe来执行你的脚本文件。第二行就是程序的输出。最后一行“exit code 0”表示程序正常结束没有错误。注意如果你看到错误提示比如“ModuleNotFoundError”或者关于解释器的错误请回到第3.1节检查创建项目时是否正确配置了Python解释器并确认是在当前项目窗口中运行。4.3 初探调试让程序“慢动作”执行运行只能看到结果而调试Debug可以让你看到程序一步步执行的过程是定位和解决复杂问题的神器。对于print(“Hello World”)这样的单行程序调试显得杀鸡用牛刀但你必须知道这个功能在哪里以及基本操作。设置断点Breakpoint在你代码行号的左侧灰色区域点击一下会出现一个红色圆点。这表示一个断点程序执行到这里时会暂停。开始调试右键点击代码区域选择“Debug ‘hello’”或者使用快捷键Shift F9。观察与步进程序启动后会在断点处暂停。此时“Debug”工具窗口会打开显示当前所有变量的值目前还没有。你可以使用工具栏上的按钮控制执行Step Over (F8)执行当前行如果当前行是一个函数调用不会进入函数内部直接得到函数结果并跳到下一行。Step Into (F7)执行当前行如果当前行是一个函数调用会进入该函数的内部。对于print()这样的内置函数按F7可能会跳转到底层实现新手暂时可以不用。Resume Program (F9)从当前暂停处继续运行直到下一个断点或程序结束。尝试在print那一行设置断点然后调试。你会发现程序在输出之前就停住了。按下F8Step Over你会看到输出出现在控制台并且程序结束。这就是调试的基本流程。未来当你的程序逻辑复杂、出现意想不到的结果时通过设置断点和步进你可以像侦探一样查看每一步执行后变量的变化从而找到bug所在。5. 超越“Hello World”项目实战与常见问题排雷成功运行第一个程序只是起点。接下来我们要在这个项目中做一些更实际的事情并预演你接下来肯定会遇到的几个典型问题。5.1 实战编写一个简易的交互式程序让我们把hello.py的内容替换成一个更有趣的小程序# 这是一个简单的用户信息收集程序 user_name input(请输入你的名字 ) user_age input(请输入你的年龄 ) # 注意input()获取的都是字符串str如果需要数字计算需要用int()或float()转换 # user_age_int int(user_age) print(f\n你好{user_name}) # 使用f-string格式化字符串这是Python 3.6的推荐写法 print(f明年你就{int(user_age) 1}岁了。) # 这里进行了类型转换和计算 # 一个简单的判断 if int(user_age) 18: print(你已经是成年人了。) else: print(你还是个未成年人。)这个程序用到了几个新概念变量 (user_name,user_age)用来存储数据。input()函数在控制台等待用户输入并将输入内容作为字符串返回。f-string格式化在字符串前加f可以在字符串内用{变量名}直接嵌入变量值非常方便。类型转换 (int(user_age))将字符串user_age转换为整数才能进行数学运算1。if-else判断根据条件执行不同的代码块。运行这个程序根据提示输入名字和年龄观察输出。你已经在写一个有点“智能”的程序了5.2 高频问题排雷与解决思路在你接下来的学习过程中几乎一定会遇到下面这些问题。提前了解可以让你在遇到时不再慌张。问题一运行时报错ModuleNotFoundError: No module named ‘xxx’场景当你尝试使用第三方库如requests,numpy或者从别处复制了一段代码过来运行时。原因你需要的库没有安装在当前项目使用的Python环境中。解决方案确保PyCharm底部Terminal标签页处于激活状态它会显示(venv)前缀。在Terminal中输入pip install xxx将xxx替换为库名如pip install requests。等待安装完成重新运行程序。为什么这么做因为我们创建项目时使用了虚拟环境venvpip install命令必须在这个环境的终端里执行库才会安装到本项目目录下的venv文件夹里。如果你在系统自带的CMD里安装PyCharm项目是找不到的。问题二PyCharm代码有红色波浪线提示“Unresolved reference”场景你明明安装了库或者导入了模块但PyCharm仍然在代码中标记错误。原因PyCharm的智能感知没有正确索引到当前解释器环境中的库。解决方案检查PyCharm右下角确认当前选择的解释器是你项目的虚拟环境如Python 3.12 (first_project-venv)。如果解释器正确可以尝试点击PyCharm顶部菜单File - Invalidate Caches...然后选择“Invalidate and Restart”。这会清除PyCharm的缓存并重启通常能解决索引问题。对于自己编写的其他.py文件确保它们在同一项目目录下并且使用正确的导入语句如from my_module import my_function。问题三代码运行没报错但结果不对或没输出场景程序正常跑完exit code 0但控制台没有预期的打印结果或者计算结果错误。排查思路检查运行的是否是目标文件有时你可能打开了多个文件PyCharm运行的是上一次的配置。确保编辑区焦点在你要运行的文件上或者去顶部工具栏的下拉菜单确认运行配置指向正确的文件。使用print进行调试在怀疑有问题的代码段前后多添加几个print语句输出关键变量的值。这是最朴素也是最有效的调试手段。例如print(f”变量a的值是{a}”)。检查逻辑错误特别是条件判断if和循环for,while的边界条件。比如if age 18:和if age 18:的结果就不同。检查缩进Python用缩进来定义代码块。如果if下面的print语句缩进不对它就不会被当作if的一部分执行。PyCharm通常会自动处理缩进但如果你从网页复制代码可能会引入制表符Tab和空格混用的问题。在PyCharm中你可以看到缩进线确保它们对齐。问题四如何安装旧版本的库场景教程里要求安装numpy1.21.0但你直接pip install numpy装的是最新版。解决方案在Terminal中使用pip install numpy1.21.0。pip允许通过,,等符号指定版本。进阶管理当项目依赖很多库时可以使用pip freeze requirements.txt命令将当前环境的所有库及版本导出到一个文件中。换到新电脑或新环境时只需运行pip install -r requirements.txt就能一键安装所有依赖。这是Python项目协作和部署的通用做法。6. 高效使用PyCharm提升编码速度的必备技巧当你熟悉了基本流程后掌握一些PyCharm的高效操作能让你的学习和开发事半功倍。6.1 代码编辑与导航技巧智能补全 (Ctrl Space)这是你最好的朋友。输入部分字符后按CtrlSpacePyCharm会给出变量名、函数名、模块名等建议。即使你不记得全名它也能根据上下文猜出来。快速查看文档 (Ctrl Q)将光标放在一个函数如print或库名上按CtrlQ会弹出一个窗口显示该对象的简要文档Docstring不用离开编辑器就能了解用法。快速跳转到定义 (Ctrl 鼠标左键 / CtrlB)想知道一个函数或变量在哪里定义的按住Ctrl键用鼠标点击它或者把光标放上去按CtrlBPyCharm会直接打开定义它的文件并定位到那一行。对于阅读和理解他人代码或自己很久以前写的代码极其有用。重命名重构 (Shift F6)选中一个变量或函数名按ShiftF6可以重命名它。PyCharm会智能地更新项目中所有引用到这个名字的地方避免手动修改遗漏导致的错误。快速复制/移动行 (CtrlD / CtrlShift上下箭头)不需要选中光标放在某一行按CtrlD可以复制该行。按CtrlShift上/下箭头可以将该行上下移动。6.2 运行/调试配置的深入理解你可能会注意到每次运行后PyCharm顶部工具栏的下拉菜单里会保存一个“hello”的运行配置。你可以点击它旁边的“Edit Configurations”进行详细设置。脚本路径 (Script path)指定要运行的Python文件。参数 (Parameters)可以在这里输入命令行参数。比如你的脚本需要处理一个文件名你可以在这里输入data.txt然后在代码中用sys.argv来获取这个参数。工作目录 (Working directory)程序运行时认为的“当前目录”。默认是你的项目根目录。这会影响像open(‘file.txt’)这种使用相对路径的文件操作。Python解释器 (Python interpreter)确保这里选中的是你项目的虚拟环境解释器。对于简单的单文件脚本通常不需要修改这些。但当你开始编写更复杂的、需要参数或特定环境变量的程序时这里就是配置入口。6.3 版本控制入门用Git管理你的代码即使是一个人学习我也强烈建议你尽早接触Git。它就像写代码的“后悔药”和“时光机”。PyCharm集成了出色的Git支持。初始化Git仓库在PyCharm顶部菜单选择VCS - Enable Version Control Integration...然后选择“Git”。这会在你的项目根目录创建一个隐藏的.git文件夹。提交 (Commit) 代码当你写完一个功能或修复一个bug后点击PyCharm左侧的“Commit”工具按钮通常是一个绿色的对勾√。你会看到一个窗口列出了所有被修改的文件。在上方的输入框里简要描述你这次做了什么例如“添加了用户输入和年龄判断功能”然后点击“Commit”。这相当于给你的代码当前状态拍了一张快照。查看历史与回退在“Commit”工具窗口你可以看到所有的提交历史。如果你新写的代码把程序搞坏了你可以轻松地回退到任何一个之前的“快照”状态。使用Git你再也不用为了保留“能运行的版本”而不断复制整个项目文件夹了。这是专业开发者的标配技能越早养成习惯越好。走到这里你已经完成了从零开始在PyCharm中安装、配置、编写、运行、调试Python程序的全过程。你不仅知道了怎么点击按钮更理解了每一步背后的意义和可能遇到的坑。编程学习是一个不断遇到问题、解决问题的循环。PyCharm是你强大的助手但它不能替代你的思考和实践。接下来最好的行动就是关闭这篇教程打开PyCharm开始尝试修改hello.py里的代码比如让程序计算两个数的和或者根据输入的成绩输出等级。每一次成功的运行和每一个被解决的错误都会让你离“Python开发者”这个身份更近一步。记住所有复杂的项目都是从一行简单的print(“Hello World”)开始的。 
函数为每条日志附加上下文信息)
