[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.pospyder-v5.4.3.pot 的内容,再用 PoEdit 编译成 spyder.mo 就可以了。有兴趣的人可以试试看。

 


Spyder IDE 操作说明

偏好设定

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

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

 

参考网页

    • Adam
    • 03/30. 2024 10:06上午
    Using Google Chrome Google Chrome 123.0.0.0 on Windows Windows NT

    我是python的初学者现正用spyder进行学习,想请教一下每当我代码打到最底部的时候,我右侧的滚轮往下到底部,不过他只能到我代码的那行,没办法预留更多空间,请问有解方吗?谢谢,不好意思打扰了

    • Using Mozilla Firefox Mozilla Firefox 117.0 on Windows Windows NT

      进到 Spyder 的偏好设定 -> 编辑器 -> 显示 -> 勾选“页面卷动可超出档案结尾”

    • cylee
    • 04/30. 2024 9:42上午
    Using Google Chrome Google Chrome 124.0.0.0 on Windows Windows NT

    感谢你提供正体中文 非常谢谢你

  1. No trackbacks yet.

return top

%d 位部落客按了赞: