[Python]Spyder IDE 5.5 繁体中文语言套件，以及一些 Spyder 的操作说明

Spyder 中文套件

Spyder 是一个功能强大的 Python 程式语言整合开发环境 (IDE)，程式内建的多国语言有支援“简体中文”，但没有“繁体中文”。

本来我只是打算把“简体中文”转成“繁体中文”就拿来使用，但却发现简体中文有很多不通顺跟错误的地方!

于是我鼓起勇气，硬著头皮，一行一行对照着英文把它给翻译完毕! Spyder 整合了很多套件，文字量比我想像的庞大，也有很多专业用语，费了一翻功夫才翻译到我觉得还算满意的成果，才敢丢出来给大家使用。

虽然说我不认为这种 IDE 需要特别翻译成中文，但对于一些刚入门 Python 的新手，希望仍有帮助。

正体中文语言套件下载

目前有两个版本，择一下载即可:

正常版 (更新日期: 2023/11/13)
大叔版 (将翻译中的“你”改成“大叔”，用起来别有一番风味)

中文化步骤

1. 进到 Spyder 的多国语言资料夹: C:\Program Files\Spyder\pkgs\spyder\locale\ (如果你是用 Anaconda，则资料夹为 %UserProfile%\anaconda3\Lib\site-packages\spyder\locale\)。

2. 下载上述的压缩档，完整解压缩到多国语言资料夹，解压缩需连同目录结构一起解，解好后会有一个 zh_TW 的资料夹，里面就是正体中文语言套件。

3. 用文字编辑器编辑 C:\Program Files\Spyder\pkgs\spyder\config\base.py (如果你是安装 Anaconda，则编辑 %UserProfile%\anaconda3\Lib\site-packages\spyder\config\base.py)。找到这行:

    'zh_CN': u'简体中文',

在下方加入一行:

    'zh_TW': u'正体中文',

改好之后储存，这一个区段的程式码长的像这样:

4. 开启 Spyder，进到选单 [Tools] → [Preferences] → [Advanced settings] → [Language] 选 [正体中文]:

5. 按 [OK] 重新启动 Spdyer 后，繁体中文接口就完成了:

PS. 我是拿 Spyder v5.4.3 的语言档来进行翻译的，放到 Spyder v5.5 也适用。

初学者可以执行一次 [说明] 选单里的 [显示导览]，有助于你了解 Spyder 的使用环境。

语言套件档案说明

本套件的压缩档里只有三个档案:

spyder-v5.4.3.pot: 未翻译的英文对照档 (文字档)
spyder.po: 翻译成正体中文的语言档 (文字档)
spyder.mo: 编译过的正体中文语言档，Spyder 只认这个档案

如果你想自己修改翻译，可以用文字编辑器或 PoEdit 编辑 spyder.po 或 spyder-v5.4.3.pot 的内容，再用 PoEdit 编译成 spyder.mo 就可以了。有兴趣的人可以试试看。

Spyder IDE 操作说明

偏好设定

如果你的萤幕是高分辨率萤幕，建议修改 [偏好设定] → [应用程式] → [接口] → 选取 [启用自动缩放]，这样软件的画面看起来比较自然。
在 [程式码] 选单里，建议至少勾选这些项目:
- 显示缩排指示
- 显示程式码折叠
- 显示类别和函式选择器
- 显示程式码样式警告
- 用底线强调错误和警告
我们都知道 Python 是一种有强迫症的语言! 在写 Code 时常会出现一堆“样式”警告，这属于排版不良，并非程式错误。我们可以进到 [偏好设定] → [程式补完与语法检查] → [样式与排版] → 勾选 [于储存时自动排版程式码]。之后再遇到这类的警告，只要按一下 Ctrl + S 储存盘案，编辑器就会自动把 Code 按规则排版好，警告也跟着消失了。
建议开启“大纲面板” (Ctrl + ⇧Shift + O)

常用快速键

F5: 整体执行
F9: 执行目前的程式行或选取范围
Tab: 于行首按 Tab 会自动缩排。当输入程式码时按 Tab 则显示程式补完提示。
Ctrl + Space: 显示程式补完 (可能会与中文输入法冲突)
Ctrl + I: 于“说明面板”显示物件的说明
Ctrl + 鼠标左键: 显示物件说明，或前往程式定义
Ctrl + Enter: 执行目前的程式单元 (可输入 "# %%" 建立程式单元)
⇧Shift + Enter: 执行目前的程式单元，并前往下一个单元
Ctrl + L: 前往指定行
Ctrl + Home: 前往页首
Ctrl + End: 前往页尾
Ctrl + Tab: 快速在两个档案切换
Ctrl + Alt + I: 自动排版程式码
Ctrl + Alt + P: 搜寻函数、方法、类别
Ctrl + 1: 单行注解
Ctrl + 4: 多行注解
Ctrl + 5: 取消多行注解
Ctrl + F: 搜寻字串
Ctrl + R: 取代字串
Ctrl + Alt + D: 在定义函式的第二行按此快速键，会帮你输入文件字串 (docstring) 范本。
Ctrl + Alt + ⇧Shift + ←: 返回最近的编辑处
Ctrl + 鼠标滚轮: 缩放字体大小
Ctrl + 0: 还原字体大小
Ctrl + ⇧Shift + O: 开启/切换到大纲面板
Ctrl + ⇧Shift + P: 开启/切换到专案面板
Ctrl + ⇧Shift + X: 开启/切换到档案面板
Ctrl + ⇧Shift + F: 开启/切换到搜寻面板
Ctrl + ⇧Shift + V: 开启/切换到变量浏览器面板
Ctrl + N: 新建档案

程式单元

于编辑器以注解的方式输入 # %% 单元名称 即可建立“程式单元”。透过程式单元，可将程式分成不同的区段，再配合以下的快速键执行区段内的程式码:

Ctrl + Enter: 执行目前的程式单元
⇧Shift + Enter: 执行目前的程式单元，并将光标移至下一个单元

程式单元操作起来就像 Jupyter Notebook 或 Google Colaboratory 那种分段的感觉。

Spyder 的程式单元有层级概念，输入多个 % 可建立不同层级，若是在类别或函式内建立程式单元，也会自动变成是内层的单元，例如:

# %% Section1
def section1():
    pass
# %%% Sub-Section
def subsection():
    pass
# %% Class
class Car:
    # %% Method
    def drive():
        pass
    def stop():
        pass

就可以在“大纲面板”看到这样的结构:

档案样板

在 Python、pydoc 以及单元测试要求模组必须是“可引用”的。即使是打算做为 Script 的档案，也应该要可以引用。你的程式应该在执行主程式前总是检查 if __name__ == "__main__"，这样当档案被引用时，主程式就不会被执行。

因此，建议修改 Python 档案的默认样板 template.py，在后面加入这几行程式:

def main():
    pass

if __name__ == "__main__":
    main()

你将主程式都写在 main() 里面，这样当档案被引用时，因为 __name__ 变了，所以便不会执行。

变量浏览器

Spyder 有个非常实用的“变量浏览器”，可以随时查看程式执行时的变量与物件的值 (包含变量的型别及大小)。在它的功能选单中:

如果你想查看 Python 内建的一些以 _ 开头的变量，请取消勾选“排除私有变量”
如果你要看到程式建立的方法与函式，请取消勾选“排除可呼叫的物件及模组”

(我也有在用 VS Code，VS Code 也有一个“变量总管”。实际使用起来，Spyder 的变量浏览器比 VS Code 的变量总管还好用，这也是我选择 Spyder 来开发 Python 程式的原因之一。)

IPython 主控台指令

用于观察:

dir(): 查看全部的变量、物件、类别
dir(<物件>): 查看物件的属性、方法
help(<物件或指令>): 查看物件的属性与方法，或指令的用法
type(<物件>): 查看物件的型别
vars(<物件>): 查看物件的属性及值
repr(<物件>): 查看物件的型别或变量的值 (原始资料)
%pdoc(<物件>): 查看物件的文件字串 (docstring)
%who: 列出所有的变量及类别名称
%whos: 列出所有的变量及类别，包含名称、型别及值
%reset: 删除全部的变量
?<物件或指令>: 查看物件的属性，或指令的用法，例如: !print 可查看 print() 函式的用法
<物件或指令>?: 查看物件的属性，或指令的用法
%env: 查看环境变量

用于执行:

runfile(): 执行目前编辑器的档案
runfile("<filename.py>"): 执行特定的档案
%run <-t> <filename.py>: 执行特定的档案，如果加参数 -t 可计算执行时间
%history: 查看历程记录
%recall: 将上一次指令的“输出”变成这一次的“输入”
%rerun: 重新执行上一次的指令
!<指令>: 执行外部程式，例如: !TaskMgr 可叫出“工作管理员”
!!<指令>: 执行外部程式，并将执行结果显示成串行的格式

用于档案:

%edit <FileName.py>: 用编辑器编辑或新增 Python 档案
%ls: 查看档案清单
%cd <Path>: 变更目录
%pwd: 查看目前的路径

其它:

_: 这是一个特殊的变量，储存上一次指令的“回传值”，可以拿来使用或显示
%clear: 清理主控台画面
%quickref: 查看全部的指令及说明

全部的指令请参考: Built-in magic commands。

以上 IPython Magic 指令前面都有 %，经我测试没加 % 也可以正常使用。但是如果指令与你程式中的物件名称相同，那你还是得打 % 才会正确执行指令。

Spyder Full & Lite

如果你是从 GitHub 下载的 Spyder IDE 安装档，它其实有分为完整版 (Full) 与精简版 (Lite) 两种版本，差别在“选用项目”里的几个模组:

以 v5.5.0 来看，档案大小的差别:

完整版 (Full): 安装程式 216MB，安装好约 892MB
精简版 (Lite): 安装程式 152MB，安装好约 551MB

官方的安装说明是建议安装完整版本，否则可能会影响到“变量浏览器”的功能。

Vixual