python无全局中文开关，需分别配置终端（utf-8编码）、ide（如vs code语言包与python扩展设置）、pip/pypi（依赖系统区域与浏览器）、matplotlib（手动设中文字体）及源文件编码声明。
Python 本身没有“设置为中文”的全局开关，print("你好") 能显示中文，不代表整个开发环境已中文化；真正需要调整的是终端、IDE、文档查看器、错误提示、包管理工具等外围环节。
终端和 shell 的编码必须设为 UTF-8
Windows CMD/PowerShell、macOS Terminal、Linux bash 默认可能不启用 UTF-8，导致 python -c "print('中文')" 显示乱码或报 UnicodeEncodeError。
- Windows PowerShell：运行
$OutputEncoding = [console]::InputEncoding = [console]::OutputEncoding = New-Object System.Text.UTF8Encoding（临时）；永久方案是修改注册表或使用 Windows Terminal + 设置"fontFace": "Consolas"并勾选“将字符集设为 UTF-8” - macOS/Linux：确保
locale输出含UTF-8，如en_US.UTF-8或zh_CN.UTF-8；若无，用export LC_ALL=zh_CN.UTF-8（加到~/.zshrc或~/.bashrc） - VS Code 终端：在设置里搜
terminal.integrated.env，添加"LC_ALL": "zh_CN.UTF-8"
pip 和 PyPI 页面语言靠浏览器与系统区域决定
pip install 命令本身不提供中文界面，但 pip search 已废弃；PyPI 网页端语言由浏览器 Accept-Language 头决定，不是 Python 控制的。
- Chrome/Firefox 中文系统下通常自动显示中文页面；手动切换可在 PyPI 右上角点国旗图标
-
pip show xxx输出始终是英文字段（如Author,License），但包作者可在setup.py或pyproject.toml中用中文填值，实际显示取决于终端能否解码 - 避免用
pip install 中文包名—— 包名必须是合法 ASCII，否则会报Invalid requirement
VS Code + Python 扩展的真正中文化要点
VS Code 编辑器本身支持中文语言包，但 Python 扩展（Microsoft 官方）的语法提示、LSP 错误信息、调试变量面板默认仍是英文，需组合配置。
立即学习“Python免费学习笔记（深入）”；
- 安装 VS Code 中文语言包后，重启编辑器，菜单/设置即变中文
- Python 扩展的 LSP（Pylance）错误提示无法翻译，但可关闭冗余提示：在设置中搜索
python.analysis.diagnosticMode，设为workspace；或禁用python.analysis.typeCheckingMode减少泛型相关英文报错 - 调试时变量值含中文正常显示，但“局部变量”面板标题、“断点”等 UI 文字来自 VS Code 主体，非 Python 扩展控制
- 关键：在
settings.json中添加"python.defaultInterpreterPath": "./venv/bin/python"（macOS/Linux）或"python.defaultInterpreterPath": ".\venv\Scripts\python.exe"（Windows），避免因解释器路径含中文空格或 Unicode 导致启动失败
第三方库文档与交互式环境的中文支持
Jupyter Notebook / IPython 控制台能正确打印中文，但 help()、docstring 查看效果取决于终端和字体；部分库（如 pandas、matplotlib）有中文文档，但 API 名称和参数名永远是英文。
- IPython 启动后执行
%config InteractiveShellApp.editor = 'code --wait'可让%edit调用 VS Code，避免系统默认编辑器乱码 - matplotlib 中文显示需手动设置字体：
import matplotlib.pyplot as plt plt.rcParams['font.sans-serif'] = ['SimHei', 'Arial Unicode MS', 'DejaVu Sans'] plt.rcParams['axes.unicode_minus'] = False
否则标题/标签显示方块 - 使用
help(str.split)得到的是英文文档；想查中文说明，得依赖第三方网站（如 菜鸟教程、Real Python 中文版）或本地生成 Sphinx 中文文档 - 注意：某些旧库（如 PyQt4）在中文路径下运行会崩溃，建议项目根目录路径全用 ASCII 字符
最常被忽略的一点：Python 源文件顶部的编码声明 # -*- coding: utf-8 -*- 在现代 Python 3 中已非必需（默认就是 UTF-8），但若文件里有中文字符串且保存为 GBK，又没声明编码，就会在 Linux/macOS 上直接报 SyntaxError: Non-UTF-8 code starting with —— 这不是环境问题，是文件保存方式错了。
