简介面向 PyCharm 2020.1 用户的官方中文语言插件安装教程重点解决 Python 开发者希望将 IDE 界面切换为中文、但不想借助第三方汉化工具的需求。资料为单个 PDF 文档压缩包仅 241KB形式轻量便于边看边操作。教程详细梳理了在线搜索、手动拖拽安装、通过 IDE 在线安装三种方法并推荐以手动下载对应版本插件的方式为主结合 PyCharm 版本查看、插件版本选择、拖拽安装后的提示处理等关键环节能有效避开插件搜索不到或安装失败等常见问题。文中还提醒了社区版与专业版在中文支持上的差异例如社区版可基本全中文专业版部分菜单仍会保留英文并给出了具体的插件版本号参考。目前已有 10645 人学习使用适合刚接触 PyCharm 或准备将开发环境本地化的开发者快速参考。1. 中文界面不用汉化这一版装起来比你想的简单第一次用 PyCharm 2020.1 的人大概都会去搜“汉化包”结果下载下来的东西五花八门装上之后工具栏倒是中文了代码提示和调试器反而开始出怪问题。其实 Pycharm2020.1 安装中文语言插件根本不需要汉化这个概念存在——JetBrains 官方发过一个中文语言包以 jar 形式挂在官方插件仓库里认准版本拖进去就行。这篇笔记会把三种安装方式全部捋一遍在线搜索什么时候能装上为什么要手动下载 jar 拖进 IDE版本号对不上时怎么处理。适合还守着 2020.1 的老项目、或者机器太旧不想升级 IDE 的开发者如果你想远程指导同事操作照着这篇发截图也能少走弯路。网上搜 pycharm 安装教程会看到各种打包汉化版凡是让你替换 IDE 自带文件的直接划走。2. 语言包的本质三种安装方式里为什么只有拖 jar 最稳2.1 官方语言包与第三方汉化的差别先说清楚一个前提JetBrains 的中文语言包不是“汉化补丁”它本身就是一个插件。PyCharm 的界面文本底层是 key-value 资源语言包在运行时替换这些字符串不动你的 Python 解释器、虚拟环境和项目配置。所以装完之后代码运行逻辑零影响卸载也干净不会像某些第三方汉化包那样在 IDE 根目录里留下半套被改过的资源文件。我一般会这样跟同事解释语言包是“官方亲生的翻译扩展”汉化包是“第三方外包的文本替换”。前者跟着 JetBrains 的版本线走插件仓库里明码标着适配范围后者主要靠作者手动跟进PyCharm 每次小版本升级都可能让界面文字变成中英混杂的“缝合怪”。这就是为什么标题里说“不需要汉化”——不是不需要中文而是不需要走汉化那条路。另外要提一个不少人忽略的点语言包在 2020.1 这条版本线上是 EAP 状态Early Access Program翻译过来类似“公开预览版”。这意味着它不像正式插件那样在 Marketplace 里永远排在最前面某些构建号下在线搜索干脆不显示。理解了这一点后面遇到“搜不到”就不会慌。2.2 三种安装方式的对比与选型理由原教程给了三种方法我按实际成功率排序方法操作路径稳定性适用场景方法一Settings → Plugins → Marketplace 搜索 chinese时好时坏网络通畅且仓库索引完整的侥幸情况方法二手动下载 jar 拖进 IDE最高版本明确本地文件可控推荐方法三官网页面点击 Install to IDE 按钮偏低浏览器与 IDE 联动正常时可用为什么方法二最稳因为它的每一步都是确定性的。你能看到自己下载的是哪个版本号拖进去之后 PyCharm 会明确告诉你能不能装装完还能在插件列表里看到它。方法一依赖仓库索引2020.1 这种老版本线经常在 Marketplace 里被过滤掉方法三则依赖浏览器把链接转交给 IDE 进程这一步在不少系统上会被安全策略拦下来点击后毫无反应是常态。这里补充一个原理层面的解释PyCharm 的插件安装本质是把 jar 拷贝到本机插件目录并注册进 IDE 的插件列表。离线拖拽相当于“手动拷贝注册”在线安装只是把下载和拷贝这两步自动化了。所以当自动化路径失效时手动路径永远兜底这也是一线工程师习惯保留离线包的原因——版本可控、可复现、可分发。3. 版本自查与插件下载先认 build 号再拿 zh.201.6668.1133.1 在 Help → About 里认准你的构建号动手下载之前必须先做一件事查看 PyCharm 的准确版本。打开 PyCharm菜单栏找到 Help → About弹出的窗口里除了显示 2020.1 这一行友好版本号还会有一行 Build201.7223.xx 之类的内容。这串 build 号才是插件兼容性判断的唯一标准。为什么不能只看友好版本号因为 2020.1 和 2020.1.1、2020.1.2 补丁版本在插件市场里可能对应不同的兼容区间而语言包的版本列表按构建线组织。第一段的 201 代表这是基于 2020.1 平台的构建线后面几段是 IDE 自身构建的增量编号。常见做法是把这串 build 号完整抄下来然后去插件下载页对比每个版本的 Since 和 Until 字段。Since 表示该插件从哪个 IDE 构建号开始支持Until 表示支持到哪个构建号为止你的 build 号必须落在两者之间。操作步骤就三步打开 About 窗口 → 找到 Build 行 → 截图或抄录完整数字。这一步别跳过我见过太多人直接下载最新版语言包然后拖进去报错回头问版本才发现他用的是 2020.2。3.2 下载页按版本行筛选插件编号 13710 与 zh.201.6668.113插件下载地址是 https://plugins.jetbrains.com/plugin/13710-chinese-simplified-language-pack-eap/versions 。这个链接可以收藏13710 是中文简体语言包在 JetBrains 官方仓库里的固定编号以后无论哪个版本都靠它进。打开页面后你会看到一个版本列表每一行右侧有下载按钮和兼容性标注。重点看版本号的第一段数字比如 zh.201.6668.113这一串的拆解方式是zh 表示简体中文语言包201 表示它面向 2020.1 平台线6668 是语言包自身的构建基准113 是构建修订号。你只需要认准 201 这个前缀找到对应行下载即可。这里有个容易踩的选型坑版本列表默认按发布时间倒序排最新的一行可能是面向 2023 甚至更高版本的直接下载拖进 2020.1 肯定会报不兼容。正确姿势是往下翻或者用页面内的过滤功能找到版本号带 201 前缀的那一行。当时在这个版本线上能拉到的最新适配包是 zh.201.6668.113对应 2020.1 社区版和大部分专业版构建。文件下载下来是一个 jar几十兆左右别解压别改文件名原样放着。另外说一句社区版和专业版的差异语言包翻译的是 IDE 基础界面字典社区版界面基本全覆盖体验接近全中文专业版因为有额外的高级功能菜单和部分插件集成页面这些内容不在语言包的翻译范围内所以装完会看到中英混杂。这不是安装失败原教程里说“专业版有一些是英文”就是这句话的意思。4. 拖拽安装与重启生效方法二全流程实操4.1 把 jar 拖进 IDE标准动作与窗口反馈方法二的核心操作只有一步把下载好的 jar 拖到 PyCharm 窗口里。但这一下拖得对不对直接决定后面十分钟要不要重新来过。标准动作是这样的先打开 PyCharm 并进入主界面别停在启动加载页然后打开文件管理器定位到刚才下载的 jar鼠标左键按住 jar把它拖到 PyCharm 的编辑区或任何工具窗口上松开鼠标。这时候 IDE 会弹出一个确认框显示插件名称和版本并提示 “Install Plugin from Disk”。点 Install插件开始安装完成后会提示 Restart IDE点击后 IDE 自动重启重启完成界面就是中文。几个细节我强调一下。拖拽的目标是整个 IDE 主窗口不是系统托盘图标也不是桌面图标。把 jar 拖到桌面上的 PyCharm 快捷方式上没有任何用处。如果 PyCharm 之前用管理员权限启动过而文件管理器是普通权限Windows 下两个进程之间拖拽经常失败表现为鼠标指针没有响应或者显示禁止图标这种时候直接把 jar 复制到插件目录再重启 IDE 也行。还有一点确认框出现后如果 IDE 识别出版本兼容问题会显示红色警告按钮可能置灰无法点击。这时候别硬装回到下载页核对版本行你的 build 号不在兼容区间内。4.2 在线安装与网页安装的正确打开方式方法一和方法三也不是完全不能用只是边界条件要讲清楚。方法一的入口路径是File → Settings → Plugins → Marketplace在搜索框输入 chinese。如果能搜到 “Chinese Simplified Language Pack”可以直接点 Install装完同样提示重启。搜不到的情况很常见原因前面说了仓库按 IDE 平台版本过滤了老构建线或者本地缓存了不完整的索引。我一般把这个搜索动作当作“探针”而不是主路径第一次搜有就直接装没有立刻转方法二不反复刷新浪费时间。方法三的操作是保持 PyCharm 运行在插件下载页面点击 Install to IDE 按钮网页会尝试唤起本机 IDE 并传递安装链接。浏览器会弹出类似“打开 JetBrains IDE”的确认框点允许之后IDE 右侧边缘会弹出插件安装提示按提示操作即可。这个方法失败率高的原因主要有三个浏览器安全策略拦截了链接唤起、IDE 没有在运行导致传递对象丢失、以及 PyCharm 版本与网页判断不一致。所以原教程说“没什么用”我实际体验下来确实如此不建议作为首选。如果拖拽或安装过程中 IDE 无响应可以打开日志看具体原因菜单 Help → Show Log in ExplorerWindows或 Show Log in FindermacOS打开日志目录后找到 idea.log搜索 “plugin” 相关行版本不兼容或文件读取失败通常会有 error 级别的记录。这条排查路径对后续所有 JetBrains 系插件都通用。提示拖拽时如果 PyCharm 没在前台运行文件多半拖不进去。先把 IDE 切到前台再拖省得来回试。5. 中文插件避坑记录五个我实际踩过的问题5.1 拖进去提示 Plugin is not compatible现象jar 拖进 PyCharm 后弹出提示说插件与当前安装不兼容安装按钮置灰或直接消失。 原因jar 的兼容区间是它的 Since/Until 字段你的 build 号不在区间里。最常见的是下载了面向新版 PyCharm 的语言包拖给 2020.1。 解决回下载页找版本号前缀为 201 的行重新下载。核对方法就是 Help → About 里的 Build 号第一段必须和插件版本号第一段一致。5.2 Marketplace 搜索 chinese 搜不到现象Settings → Plugins → Marketplace 里输入 chinese列表空白或只出现无关插件。 原因插件仓库对老版本 IDE 的索引展示不完整加上本地缓存可能用了旧数据陈旧的索引不会主动刷新出 EAP 状态的语言包。 解决不刷新、不重试直接打开 13710 插件的版本页下载 jar走方法二离线安装。在线搜不到不是你的操作问题是仓库过滤逻辑决定的。5.3 装完提示重启重启后界面还是英文现象点了 Restart IDE重启完菜单栏依然是英文。 原因安装过程被中断或者 jar 没有真正写入插件目录。Windows 上杀毒软件拦截文件写入、macOS 上 Gatekeeper 限制都是常见元凶。 解决先到 Settings → Plugins → Installed 里确认语言包是否存在且处于 Enabled 状态。如果没有重新拖一次存在但无效就把 IDE 彻底退出再启动一次。还是不行就手动把 jar 放到插件目录Windows 是 %APPDATA%\JetBrains\PyCharm2020.1\pluginsmacOS 是 ~/Library/Application Support/JetBrains/PyCharm2020.1/plugins放好重启。5.4 中文界面后教程里的英文菜单路径对不上了现象装完中文界面网上搜索到的解决步骤让你打开 Settings你看到的菜单是“设置”多绕一层查找。 原因语言包替换了 UI 文本老教程的英文路径不再直接适用不是 IDE 出了问题。 解决记住几个高频菜单的中英对照File/文件、Settings/设置、Plugins/插件、Marketplace/市场、Restart IDE/重启 IDE、Appearance/外观。后续找任何设置都按中文路径走比硬记英文位置快得多。5.5 专业版装完中英夹杂现象PyCharm 专业版装好语言包主体菜单是中文但部分窗口或右键菜单仍是英文。 原因语言包翻译的是 IDE 基础界面专业版专属功能和一部分第三方插件界面不在覆盖范围内这是 EAP 语言包的翻译边界。 解决这不是 bug不需要重装。社区版基本全中文专业版接受部分英文即可。如果界面语言混排影响操作用第六节讲的切换方式回英文状态。6. 装完验收与语言切换三分钟确认插件是“活的”装完重启之后别急着写代码先花一分钟做验收。我习惯按这个清单过一遍检查项通过标准菜单栏文件、编辑、视图等全部中文右键菜单重构、运行、调试等关键项能看懂Settings 路径文件 → 设置能正常打开代码编辑器行号、折叠标记正常无错位乱码Help → About底部能看语言包版本信息如果这几项全过说明语言包正确加载插件目录里的 jar 被 IDE 正常读取了。这里再教一个很多教程不会提的技巧想临时回到英文界面不需要卸载插件在文件 → 设置 → 插件 → 已安装里取消勾选语言包重启后就是英文想换回中文重新勾上再重启。我通常留着一个英文版本和一个中文版本的切换习惯排查自带 UI 问题时会切到英文日常开发用中文。另一条长期有用的习惯是下载下来的中文语言包 jar 不要放在下载文件夹里吃灰放到一个固定目录比如 Windows 的 D:\IDE_Plugins 或 macOS 的 ~/Documents/ide-plugins。这样重装系统、换电脑、或者同事需要时同一个 jar 可以直接复用不需要重新去下载页翻版本列表。2020.1 配 zh.201.6668.113 这个组合前后给同事复现过不下十次没有翻过车。从那以后我每次给别人装中文语言包第一件事都是让对方发 Help → About 截图确认第一段 build 号再发对应 jar再没走岔过。希望帮到你。本文还有配套的精品资源点击获取