尧图网站设计 尧图网站设计YAOTU DESIGN
ARTICLE DETAIL

资讯详情

深耕网站设计与一线实操的经验洞察。

PyCharm 2019安装与配置详解:解释器、Anaconda与调试技巧

PyCharm 2019安装与配置详解:解释器、Anaconda与调试技巧 1. 安装前的准备工作版本选择与环境梳理1.1 为什么是 PyCharm 2019现在还值得装吗先说结论这版本我一直在用哪怕后来出了2020、2021甚至更新的大版本我手上几台配置不高的办公机器仍然装着2019系的PyCharm。原因很简单启动快、占用内存相对低、操作逻辑和现在主流版本几乎一样对于初学Python或者日常写脚本、写自动化、做数据分析来说完全够用。很多朋友会问既然官网现在主推新版为什么还要折腾一个老版本我遇到过几类典型场景一是电脑配置比较旧装新版PyCharm动不动就卡风扇呼呼转二是部分教材、网课和公司内部项目还在用2019版本的界面截图跟着学的时候找不到对应按钮三是有些第三方库的旧分支只在旧版开发环境中验证过换新版后反而出现兼容性报错。所以PyCharm 2019并不是“过时的东西”而是一个成熟稳定的版本对特定人群反而更顺手。这篇教程我会尽量把话说得直白从下载、安装、配置解释器到跑起第一个程序每一步都会配上我实际操作时的心得和踩坑记录。不管你之前有没有接触过Python只要你手里有Windows电脑按着操作基本不会出大问题。Mac和Linux的安装逻辑我会在中间单独提一嘴关键点一样。1.2 社区版和专业版到底差在哪PyCharm在2019时代就分成了两个版本Community社区版和Professional专业版。我第一次装的时候也纠结过半天后来用久了才理解它们的分工。社区版是免费且开源的日常学习Python、写普通脚本、做网页爬虫、跑数据分析这些场景完全够用。它内置了编辑器、调试器、运行器、版本控制Git/SVN等核心功能甚至对Django这类Web框架也有基础支持。想装第三方库、看变量值、设断点调试都没问题。专业版是收费的商业版本额外提供远程开发、数据库工具、Docker支持、JavaScript和SQL等语言的支持以及更完整的Web框架集成。实际开发中如果你只是初学Python专业版多出来的东西基本用不上还会因为功能太杂增加资源占用。我的建议是学生、自学者、普通脚本爱好者直接装社区版就够了。等到你确实需要远程部署、多人协作、数据库联调了再考虑专业版到时候用自己的JetBrains账号申请30天试用或者订阅都是顺理成章的事。顺带提一句2019版本里社区版和专业版的安装包是分开下载的不像后来某些版本出一个大安装包让你在安装时选择类型。所以下载之前就把需求想清楚省得白下一遍。1.3 安装前先理清Python装没装位数匹配吗很多人一上来就直接装PyCharm装完才发现没有Python解释器项目建好了却跑不起来。为了避免重复走弯路我建议先确认两件事。第一电脑上有没有安装Python。检查方法很简单Windows下打开命令行输入python --version如果能显示类似Python 3.7.4的版本号说明已经装好如果提示不是内部或外部命令就是没装或者没配环境变量。我的做法是不管有没有装都建议去Python官网下载一个和系统位数匹配的版本。PyCharm 2019对Python 3.7、3.8等版本支持很好但要注意如果你装的是Python 3.10以上的新版解释器有些旧版PyCharm的自动识别可能不够灵光所以2019版本最好搭配Python 3.8或更早的解释器跑起来最省心。第二看系统类型。Windows系统右键“此电脑”选“属性”在“系统类型”里能看到是64位还是32位。现在绝大多数电脑都是64位下载Python和PyCharm安装包时都选64位版本就行。如果选了32位后面安装某些依赖库时会莫名报架构错误。还要特别强调环境变量。Windows下安装Python时安装界面底部有个“Add Python to PATH”复选框很多人就是没勾这个导致命令行里找不到python命令PyCharm也无法自动发现解释器。如果你已经装好了但没勾最简单的方法是卸载重装一遍勾上这个选项不想重装的话可以手动把Python安装目录和Scripts目录加到系统PATH变量里这个操作我会在第3部分详细说明。另外如果你同时装了Anaconda那情况会略复杂一些。Anaconda自带了一个Python解释器和一大堆科学计算库PyCharm是可以直接调用它的。具体怎么配置我放在第3部分一起讲因为那是很多pandas和numpy用户绕不开的需求。2. PyCharm 2019下载与安装全程实录2.1 从哪下载最安全渠道问题别大意关于下载渠道我多说几句。PyCharm的官方下载地址是JetBrains官网2019版本的安装包在官网的“Archive”历史版本区域是可以找到的。正规渠道下载的安装包数字签名完整不会莫名其妙被杀毒软件拦下也不会有捆绑软件的风险。以前有些朋友图方便在第三方下载站找“破解版”或“绿色版”结果要么是安装包被改了东西要么是激活工具里带木马最后得不偿失。我的原则一直很明确涉及开发工具务必用官方渠道。JetBrains官网的下载页面默认展示的是最新版本要找2019老版本需要点一下“Download”页面下方或者侧边的“Previous versions”或者“All versions”之类入口不同时期的页面入口位置略有差别。进入历史版本列表后选择2019系列里的最新修复版比如2019.3.x这类版本比同年早期版本修了不少小毛病稳定性最理想。下载的时候注意区分“Windowsexe”、“macOSdmg”、“Linuxtar.gz”等不同平台安装包。Windows安装包通常是一个几百MB的exe文件体积不算小但和现在动辄1GB多的新版相比已经很轻了。2.2 Windows下的安装步骤一步步来安装包下载完毕后双击exe文件如果系统弹出用户账户控制提示选择“是”即可。2019版的安装向导很傻瓜化但我还是要提几个值得留意的点。第一步是选择安装路径。默认路径在C盘Program Files下如果你C盘空间紧张或者有软件一律装D盘的习惯点“Browse”改成其他盘符。需要留意的是路径中尽量不要出现中文否则有些Python库在编译安装时可能因为路径编码问题报错。第二步是安装选项。安装向导会让你勾选一些附加项常见的有“Create Desktop Shortcut”创建桌面快捷方式、“Update PATH variable”把PyCharm加入PATH还有“.py”文件关联等。我的建议是桌面快捷方式勾上加入PATH这个选项勾不勾影响不大因为PyCharm主要在IDE内部操作不像纯命令行工具依赖PATH“.py”文件关联看你个人喜好如果经常双击py脚本直接打开可以勾上否则建议保持默认。第三步是选择开始菜单文件夹保持默认直接Next就可以。确认无误后点Install开始安装整个安装过程大约需要两三分钟具体速度取决于硬盘和内存。安装完成后勾选“Run PyCharm”启动程序第一次启动时会让你选择导入配置文件如果是全新安装选择“Do not import settings”即可。2.3 首次启动主题选择与基本外观设置首次打开PyCharm 2019它会要先做一个简单的人性化设置选择UI主题。界面主题有“Darcula”深色和“Light”浅色两种。深色主题对长时间盯屏幕比较友好浅色在光照强烈的环境下看得更清楚。我一般选Darcula反正后面随时可以在设置里切换。如果你想更个性化一点等进入主界面后打开“File”菜单下的“Settings”找到“Editor Color Scheme”可以调整编辑器配色比如换成暖色调的Visual Studio主题。同一个位置还可以调整字体大小和行距对保护视力很有帮助。初次使用建议把编辑器字号从默认的12或13调到14或15同时显示行号后面写代码找问题会舒服很多。接下来是创建第一个项目的界面。点击“Create New Project”会弹出项目设置窗口。这时先别急着一路点确定因为这个窗口里的“Base interpreter”就是我们前面提到的Python解释器很多人就是在这个环节卡住。2.4 安装完成后的第一件事确认配置界面进到PyCharm主界面后强烈建议先打开“File Settings”看看整体选项是否正常。在左侧列表找到“Project: 项目名 Project Interpreter”右边会显示当前用的Python解释器路径和已安装的包列表。如果这里显示的是“No interpreter”说明解释器还没配置好需要手动添加。这一步是整个安装过程的分水岭能在这块正确配置解释器后续写代码、跑程序就水到渠成配置不对就算PyCharm界面再好看也没法运行代码。所以我把解释器配置单独拎出来放在下一部分重点讲解。3. 核心环境配置让PyCharm真正跑起来3.1 Python解释器是怎么被PyCharm识别的我举一个生活化的例子。PyCharm本身只是一个文本编辑工具加上项目管理工具它认识py文件的语法高亮但它不知道“运行的代码”该由哪个Python程序来执行。解释器就是负责执行这些代码的引擎。一个项目必须绑定一个可用的解释器才能真正点“Run”按钮。PyCharm 2019添加解释器的入口很好找在项目设置窗口的“Base interpreter”那一栏点右侧的下拉框或齿轮按钮选择“Existing environment”或“Add...”。如果之前装过Python它会自动尝试扫描系统里常见的安装路径发现后直接显示在下拉列表里。没有扫描到的话手动点文件夹图标定位到Python的安装目录里面的python.exe文件。比如我电脑上的路径是D:\Python38\python.exe选好后确认就能用了。同时需要注意从2019版本开始JetBrains鼓励用“Virtualenv”来为每个项目创建独立的虚拟环境。新手可能觉得多此一举但这个习惯很值得培养。在创建新项目时把“New environment using”选成VirtualenvPyCharm会基于你指定的基础解释器为当前项目生成一份独立的Python副本。这样不同项目之间互不干扰想装什么库就装什么不怕把系统环境弄乱。3.2 配置系统Python解释器手动添加的完整过程假设你已经提前装好了Python 3.8但PyCharm没有自动识别出来。打开“File Settings Project Project Interpreter”点右上角的齿轮图标或“Add”选择“System Interpreter”系统解释器然后点右边的“...”按钮浏览文件。找到python.exe的位置常见默认路径是C:\Users\用户名\AppData\Local\Programs\Python\Python38\python.exe。如果找不着可以在命令行执行where python它会把路径直接打印出来。选好python.exe之后PyCharm会读取这个解释器的版本和已安装的包列表下方会显示一堆包名。如果一切正常点“OK”保存项目解释器就算配置完毕了。此时我们在项目里新建一个main.py文件输入print(hello pycharm)右键选择“Run main”底部控制台就能输出结果。这里我要特别提醒一句如果你装的是Anaconda添加解释器时不要选python.exe所在的普通路径而是要选Anaconda对应环境下的解释器。很多用pandas和numpy的朋友遇到过装了库但PyCharm里导入失败的情况多半就是这个原因。3.3 Anaconda与PyCharm 2019的联合配置Anaconda是一个打包了Python解释器和一大堆常用库的科学计算环境广泛用于数据分析、机器学习和学术研究。如果你电脑里已经装了AnacondaPyCharm 2019完全可以直接调用不需要再单独装一套Python。在“Project Interpreter”设置里点击“Add”选择“Conda Environment”然后在“Conda executable”里选择Anaconda安装目录下的conda.exe。Windows默认路径一般是C:\Users\用户名\Anaconda3\Scripts\conda.exe或C:\ProgramData\Anaconda3\Scripts\conda.exe。选好conda.exe后下方“Use existing environment”会列出Anaconda里的所有环境通常有一个叫base或root的环境这是Anaconda默认的基础环境pandas、numpy、matplotlib这些库都在里面直接选它就行。配置完之后你在PyCharm里import pandas、import numpy都会直接生效不需要在PyCharm里重复安装。我们平时说的“PyCharm配置anaconda环境”本质就是把解释器指向Anaconda里的某个环境不用搞什么额外的魔法操作。补充一个常见坑如果你先用普通Python解释器创建了项目后来又装了Anaconda需要去刚才说的Project Interpreter设置里手动把解释器切到Conda环境否则项目里import pandas仍然会报ModuleNotFoundError。3.4 配置完成后新建项目并运行Hello World解释器配置完成后就可以完整跑一个项目了。新建项目时选择“Empty Project”或“Pure Python”在建好的项目上右键选择“New Python File”命名时不用加.py后缀PyCharm会自动补全。写下代码print(Hello, PyCharm 2019!)右键选择“Run”看到底部控制台输出内容就说明安装配置这条链路从头到尾已经打通了。这一步看似简单但实际上能暴露很多问题。比如有的朋友明明配置了解释器但运行时提示No Python at ...这通常是因为解释器路径变了或虚拟环境被损坏解决办法是回到Project Interpreter里重新选定。还有的朋友运行后控制台一片空白什么都不输出这种情况可以先点一下“Build”菜单里的“Rebuild Project”还不行就重启PyCharm基本能解决。4. 新手必看常用功能与效率设置4.1 中文界面怎么设置别再去搞汉化包“PyCharm怎么设置中文”这个话题在搜索榜上一直排得很靠前。2019版本的PyCharm自身没有官方的中文语言包但JetBrains后来推出了中文语言插件而且不少第三方汉化包也兼容2019。操作方法是打开“File Settings Plugins”在Marketplace搜索“Chinese”找到“Chinese Language Pack”这类插件点击Install安装后重启IDE即可。我个人对中英文界面的态度比较开放。前期不熟悉英文菜单的时候用中文确实能降低门槛但用一段时间后建议切回英文。原因是网上的教程、官方文档、报错信息绝大部分都是英文你如果习惯了中文界面看英文教程时容易对不上对应按钮和选项。而且调回英文界面只是一行配置的事完全不麻烦。如果不是必需尽量别去下载一些来路不明的汉化包那种往往通过直接覆盖jar文件来实现汉化容易导致部分功能异常或启动失败。如果你手头遇到了“汉化后菜单错乱”的情况直接卸载汉化包或者把安装目录里的原始jar文件恢复回去就能救回来。4.2 安装第三方包pandas、requests、flask 等写Python基本离不开第三方库。PyCharm 2019提供两种安装方式我分别说清楚。第一种是图形化操作。打开“File Settings Project Project Interpreter”右侧会列出当前环境已安装的包。点列表右下角的“”号在搜索框输入包名比如pandas点“Install Package”下方状态栏会显示进度。这种方式适合新手但有时会因为网络慢或者包依赖复杂而失败。第二种是命令行方式。在PyCharm底部找到“Terminal”标签打开终端窗口直接用pip命令安装pip install pandas pip install requests pip install flask如果遇到权限问题可以加上--user参数如果网络慢可以临时指定国内镜像源比如pip install pandas -i https://pypi.tuna.tsinghua.edu.cn/simple这种方式速度快、反馈信息清晰以后排查问题也方便。我个人更推荐第二种因为命令行能直接看到安装过程、依赖解析情况和错误原因。图形化安装如果报错错误信息经常被折叠或者不够明显处理起来反而麻烦。需要提醒的是如果当前项目用的是Virtualenv虚拟环境那么pip命令要在PyCharm的Terminal里执行而不是在系统全局命令行执行否则会装到系统环境里项目里import不到。4.3 断点调试比print好用一百倍很多初学者习惯用print来看程序跑到哪了这当然没问题但一旦程序逻辑复杂了print就会变得一团糟。PyCharm 2019的调试功能非常成熟学会断点调试对后续写代码帮助巨大。用法很简单在编辑器左侧的行号区域单击会出现一个红色圆点这就是断点。点击主界面右上角的“Debug”按钮绿色虫子图标程序就会运行到断点处停止。然后可以用“Step Over”逐行执行当前函数用“Step Into”进入函数内部用“Watch”区域观察某个变量随时间的变化用控制台直接执行当前作用域内的表达式。整个过程直观且高效。我第一次真正学会调试是在处理一个列表去重的问题上原本用print来回打印中间结果费了半天劲也没找到问题。后来在PyCharm里打上断点盯着变量列表逐步执行五秒钟就发现问题出在修改列表时下标越界。所以真心建议新手安装好PyCharm之后第一时间学会Debug工具这会让你省下大量排查逻辑错误的时间。4.4 常用快捷键与全局配置优化PyCharm 2019默认的快捷键方案有Windows、macOS、Linux之分但常用功能都差不多。我列出几个最高频的你可以在使用中逐渐熟悉运行当前文件Ctrl Shift F10Windows或 Control Shift RmacOS调试当前文件Shift F9Windows查找文件/类/符号双击Shift全局搜索Ctrl Shift F格式化代码Ctrl Alt L注释/取消注释Ctrl /重命名变量Shift F6快速修复Alt Enter另外在“Settings Keymap”里可以自定义快捷键。如果你是新手我想建议你保持默认方案因为网上的教程和官方帮助默认都是这套按键改了之后反而对不上。除了快捷键还可以调整一些默认行为。比如在“Settings Editor General Code Completion”里把“Case-sensitive completion”改成“None”这样输入小写也能提示大写开头的类名和方法名对国内用户特别友好。再比如在“Settings Appearance”里勾选“Show memory indicator”编辑器右下角会实时显示内存占用方便你观察是否因为项目太大导致卡顿。5. 常见问题与调试技巧实录5.1 Microsoft Visual C 14.0 is required 的报错这个报错在安装第三方库时出现频率极高尤其是安装那些包含C扩展的包比如pandas、scrapy、lapack相关的库时很容易遇到。报错信息大概是error: Microsoft Visual C 14.0 is required. Get it with Microsoft Visual C Build Tools很多人一看到“错误”两个字就慌了其实原因很简单有些Python包不是纯Python代码它们包含C/C源文件安装时需要用C编译器把这些源文件编译成二进制。PyCharm本身不会编译它调用的是系统里的MSVC编译工具。系统没有装这些编译工具pip就会抛出这个提示。解决办法有两个大方向。第一个方向是装“Microsoft Visual C Build Tools”从微软官网下载安装后再重新执行pip安装命令。注意装的时候要勾选“C生成工具”和对应的Windows SDK组件。这个方法一劳永逸以后凡是带C扩展的包基本都能顺利装。第二个方向是装预编译的wheel包。很多常用库在PyPI上提供了编译好的Windows二进制文件文件名以.whl结尾pip会自动优先选择wheel包不需要本地编译。如果你的pip下载的是源码包可以在命令里加--only-binary :all:来强制禁止源码安装强制只下载预编译版本。顺带说明一下2019版本的PyCharm年代很多第三方库如pandas、numpy都还不太支持特别新的Python版本。如果你在装这类库时老出错可以检查一下解释器是不是装的Python 3.8或3.9换成3.8的Python环境之后大部分兼容性问题都会消失。5.2 PyCharm找不到解释器或Conda路径出错有朋友遇到“没有配置Python解释器”或者“PyCharm提示Conda路径错误”的情况。先说普通解释器找不到的情况。在“Project Interpreter”设置里点击Add选择“Existing environment”右键点击“...”手动导航到python.exe。如果C盘系统用户目录下的AppData文件夹是隐藏的需要在文件夹选项里打开“显示隐藏文件”否则看不到Python路径。再说Conda路径错误的情况。有些电脑装了多个Anaconda版本或者之后又手动改了位置PyCharm里保存的Conda路径就失效了。解决方法是先在命令行执行where conda获得conda的实际路径再到PyCharm的“Add Conda Environment”里把这个实际路径填上。注意不能直接填Anaconda的根目录要填到Scripts\conda.exe这一层。还有一类情况是PyCharm的终端窗口里执行conda activate时提示命令不被识别这通常是因为Anaconda没有把自身目录写入PATH环境变量。解决方法是重新执行Anaconda目录下的Scripts\activate脚本或者直接在“Settings Terminal Shell path”里指定为Anaconda自带的cmd。5.3 关于激活与授权的几条正规途径PyCharm 2019的专业版是商业软件官方对授权和激活有明确规定。我不能也不会在这里提供任何破解工具或非正规激活码因为那些渠道不仅容易携带恶意代码而且违反软件许可协议可能导致不可预知的安全风险。我建议你走正轨。如果你是学生或教师可以申请JetBrains的免费教育授权。进入JetBrains官网的教育计划页面使用学校提供的教育邮箱通常是.edu或学校官方域名提交申请审核通过后会收到为期一年的免费专业版使用权限到期后可以续期。如果你是开源项目的核心开发者JetBrains也有开源项目免费授权计划。只要你的项目满足开源协议、有持续活跃的发布记录等条件就能申请免费的专业版许可。如果你只是个人学习用途最合适的方案就是直接使用社区版功能完全满足学习和日常开发。如果后续确实需要专业版的一些高级功能比如远程开发、数据库工具、前端支持再考虑订阅。订阅价格不算便宜但它是正规、稳定、安全的唯一出路。说句实在话专业版多出来的功能不是每个开发者都能用上花钱之前先想想自己需求是否匹配。5.4 常见错误和问题查漏补缺速查表ImportError: No module named pandas解释器不对或者包没装进当前解释器环境。去Project Interpreter确认环境和包。SyntaxError: invalid syntax代码语法错误一般是少了冒号、括号不匹配或者中英文标点混用。建议开启“Settings Editor Inspections”里的语法检查。Process finished with exit code 0程序正常结束没有输出说明代码里没有打印内容或者print被注释掉了。控制台中文乱码在“Settings Editor File Encodings”中把项目编码、全局编码和属性文件编码都设为UTF-8此外在“Run Configuration”里的VM options加上-Dfile.encodingUTF-8。界面卡顿关掉不必要的插件减少同时打开的项目数量增加“Help Change Memory Settings”里的最大堆内存。2019版本默认内存值比较保守我一般调成768MB或1GB。双击py文件打不开检查文件关联是否关联到PyCharm或者右键用Open With选择PyCharm。每个问题看起来都像技术障碍但绝大多数背后都是一些很简单的配置遗忘或版本冲突。在动手重装PyCharm之前先把上面几条挨个核对一遍往往能省下大把时间。6. 一些我后来才想明白的使用心得我刚开始用PyCharm 2019的时候总觉得必须把界面调得漂漂亮亮、插件装到最多才显得专业结果电脑越用越卡开项目要等十几秒彻底背弃了选择旧版的初衷。调整思路后我保留了必要的中文语言插件、一个喜欢的颜色主题其他能不来就不来启动速度立刻回来了。其实对于一个学习工具来说能用得顺手才是最重要的而不是功能越多越牛。如果你是为了应付学校的Python课或者网上的实训项目那2019版真的很合适因为它的菜单结构、运行方式和各类Python教程里的截图几乎一一对应不会出现“课件上用PyCharm 2019截图你手里是新版2024”这种对不上号的情况。等你熟悉了基础流程以后想升级到新版也不会有任何障碍毕竟老底子在那里操作迁移非常平滑。最后再分享一个小技巧当你的项目文件越来越多最好按目录去组织比如把爬虫、数据分析、Flask练习分到不同文件夹每个文件夹里再放单独的虚拟环境。这样既方便以后回看和复用也能让PyCharm的性能始终维持在比较理想的状态。2019版本稳定可靠好好配置当成你长期写Python的工具完全没问题。
返回列表