真正的Python社区闲置是一个以英语为媒介的 Python 社区,成员遍布世界各地。这是一个热情的小组,您可以在其中自由讨论您可能遇到的任何问题,庆祝您的进步,或者在虚拟饮水机旁与社区一起闲逛。
如果您想执行以下操作,本指南适合您:
- 充分利用 Real Python松弛社区
- 导航一些Slack 最有价值的功能
- 拿你的已回答的问题由其他 Real Python 成员
- 学习该做什么和不该做什么保持平稳
欢迎您提出任何建议或问题。您可以在 Slack 中或在下面的评论中与管理员分享。在 Slack 上,您可以通过某人姓名旁边的 Real Python 符号来判断某人是否是管理员。
免费奖金: 关于掌握 Python 的 5 个想法,为 Python 开发人员提供的免费课程,向您展示将 Python 技能提升到新水平所需的路线图和思维方式。
享受生活、保持好奇心、提出问题并尊重他人
Real Python Slack 社区中的人们都很友好,喜欢回答问题和闲逛。对于希望扩展知识和建立友谊的初学者和更高级的 Python 爱好者来说,这是一个极好的资源。
不存在愚蠢的问题——不存在这样的事情!有趣的是,初学者的问题往往会引发有关 Python 和编程的最令人兴奋和深入的讨论。所以,拜托,问吧!
Real Python Slack 社区不是一个对抗性论坛——每个人都在这里学习,并且人们乐于提供帮助。所以听并彼此优秀。你会交到一些朋友的!
当然,在线交流面临着面对面交流时所不存在的挑战。如果您有任何问题,请随时与其中一位管理员联系:
- 巴托什·扎钦斯基
- 盖尔·阿恩·耶勒
- 莱奥丹尼斯·波索·拉莫斯
- 马丁·布鲁斯
- 菲利普·阿克萨尼
他们将很乐意尽其所能地帮助您。
如果您想知道如何导航、受益于社区并为社区做出贡献,那么您可以继续阅读一些有用的提示和指南。在本指南的其余部分中,您将掌握一些该做和不该做的事情,以保持事情顺利进行。
找到提问的最佳渠道
有几个 Slack渠道您可以在其中提问。大多数频道专注于特定主题或专业。当您加入 Slack 时,您会自动添加到一些常规频道。您还可以自由(并且被鼓励)加入 Slack 社区中存在的任何其他频道。
您可以通过单击找到可用频道的列表+频道菜单旁边的图标。选择您要加入的频道,然后点击加入按钮。例如,您可能想加入#webdev, #数据科学, 和#职业生涯如果您对这些主题感兴趣,请通过以下渠道:
加入几个频道后,您可以在与您的问题最密切相关的频道中提出问题。如果您的问题不属于特定类别,那么#编码问题是适合您的频道。
花一些时间提出你的问题
当你遇到问题并且很着急时,你可能会很想跳到 Slack 上,粘贴所有代码,然后编写它不起作用。不幸的是,这肯定会让人们忽略你的问题。会心如何提问很难!
这几天,大家都很忙碌,也都很匆忙。想象一下,您打断了一位同事并要求他们帮助您解决问题。你不会带上你的笔记本电脑,把它放在他们面前,然后说它不能工作。你展示以可能引起有用回应的方式向他们提出问题:
你的问题越复杂,别人就越有可能不知道答案,并可能认为这个问题是他们不知道的。代码很难阅读——无论您的技术水平如何,都需要时间和精力。
花一些时间收集您的想法并提出具体问题以及代码,一篇文章.
总结您的问题
用一两句话总结问题可以大大帮助人们帮助你——糟糕的总结可能会让人们失去兴趣:
-
不: 该代码不起作用。
-
Do: 为什么使用
float
代替int
当我的所有输入都是整数时,给我不同的结果?
每个人都很忙,所以如果你能在第一句话中总结你的问题,人们会更容易了解情况并快速提供帮助。
有时,您可能会得到似乎无法直接解决您面临的问题的回复。不要对你的同事感到沮丧,而要考虑你的总结是否清楚、准确地指出了问题。如果您需要,请恭敬地感谢社区的回复,然后在原始帖子的帖子中发布更新的摘要。
为您的问题提供背景信息
给出背景和总体目标有助于防止XY问题。如果你有一个想法,这种情况往往会发生解决方案并询问如何实现这一点,而不提供原来的问题。原来的问题可能有另一种你没有想到的解决方案。忽略上下文并且未能描述您最初的问题可能会导致您和决定帮助您的人浪费很多精力。
例如,您想要使用 Python 运行 shell 脚本,但您不知道如何导航到正确的文件夹来运行它。有人花了很多时间教你如何运行文件以及使用 Python 运行 shell 脚本的陷阱。然后你发现 shell 脚本所做的只是删除文件,帮助者会问:你为什么不放弃 shell 脚本并用Python来做?
问题的背景(您面临的实际问题)通常比您尝试的解决方案重要得多。因此,当您提出问题时,请务必提供一些背景信息。
提供一个最小的可重复示例
请尝试提供一个最小可重复示例。提供最小的可重现示例意味着提供足够的代码和说明,以便有人可以重现您的环境并重现您正在经历的不良行为。
当代码不起作用时,尤其是当代码超过十行时,仅通过阅读很难找到错误。自己运行和调整代码来发现问题会更有效。这种效率就是为什么最小的可重现示例如此实用——就像有一群专家聚集在您的计算机周围修改您的代码。
如果您的问题与您的环境密切相关,请明确说明。明确指出其他人无法重现此情况。也就是说,您必须接受这个问题对于其他人调试来说将是一个挑战。
提供追溯
声明某件事不起作用并不能提供太多信息。另一方面,回溯或错误消息Python 产生的信息非常丰富。
然而,回溯可能很难破译,而阅读回溯是一项需要数年时间才能掌握的技能。尽管如此,始终提供代码的错误消息或输出。输出提供了有关问题所在的基本线索,经验丰富的编码人员可能能够破译这些线索。
请勿交叉发帖
作为一般规则,请不要交叉帖子您向多个渠道提出问题。在一处发帖可确保人们在一个明确的地方回答您的问题。如果您交叉发帖,那么当其他人已经在其他地方回复过您的问题时,您可能会让成员花时间回答您的问题。
如果您因为不小心交叉发布而需要删除您的问题,请参阅删除和编辑您的帖子.
尝试自己解决问题
Real Python 社区喜欢帮助和回答问题,但他们不会为您做工作。他们不会完成你的家庭作业!他们是来帮助你的学习,最好的学习方法是正在做.
埃里克·利珀特有一篇经典文章如何调试小程序,这是调试时采用的一般方法的极好指南。
如果您是初学者,那么您还应该查看了解 Python 回溯。该教程将帮助您更好地了解代码中发生的情况,这将帮助您在 Slack 社区中提出更好的问题。
不过,不要伤透了你的头——如果你被困住了,也没什么可耻的。请问!只需包括您迄今为止尝试过的内容即可。
处理未解答的问题
您的问题没有得到解答可能会令人沮丧。如果您发现您的问题没有得到解答,那么可能值得提出你自己几个问题:
当你问自己已经过去了多少时间时,如果答案只是几个小时,那就给它更多的时间。大多数成员都有全职工作,只有在有空闲时间来学习 Python 技能时才会查看 Slack。
时区也是一个至关重要的因素。当你发布问题时,最终回答你问题的人可能正在睡觉。因此,好好睡一觉吧,这不仅能让你的大脑有时间在潜意识中解决问题,而且你醒来后可能会得到一个有用的答案。
您还应该查看本指南的注意事项,以检查是否遗漏了某些内容。你有包括你的回溯或错误消息?是全部包含相关代码和格式正确?这些都可能会影响会员提供帮助的能力,因此值得看看您是否可以修改您的问题并使其更容易被其他人理解。
当您是初学者时,可能很难知道要包含哪些信息以及要省略哪些信息,但这没关系。通过练习会变得更容易。请遵循上述准则,不要让疑虑阻止您发布问题。 Real Python 社区充满了热情、慷慨的人们,他们将竭尽全力为您提供帮助。
如果您已经等待了足够的时间并且确定您的问题清晰且具有描述性,那么您也可以考虑是否在正确的位置提出了您的问题。它会更适合不同的渠道吗?如果是这样,您可以改变交叉发布指南并分享您的问题的链接在另一个频道中:
提供原始问题的链接可确保仍然只有一个地方可以提供答案。它还将人们链接回原始问题中可能发生的任何先前讨论。
如果您已用尽所有这些选项,那么您可以考虑在会员专区中提出您的问题工作时间。发布一个关联在 #office-hours 频道中提出您的问题,主持人将会解答。
最后,如果上述方法均未产生结果,请直接联系 Slack 中的一位管理员。他们可以帮助您找到解决方案或为您指明正确的方向。
不要放弃
成为一名优秀程序员的部分因素是坚韧。即使您的问题没有得到任何答复,也要继续尝试。也许这是一件非常具体或困难的事情,以至于没有人感觉到他们can帮助。
当您最终解决问题时,社区很乐意听到您的胜利和解决方案。因此,请分享,并让社区加入您的学习之旅。
将您的回复分组到主题中
如果您想回复其他成员的帖子,请使用在话题中回复按钮。使用线程将有关该主题的整个对话保留在一处,以便可以跟踪对话:
线程功能是确保对话不会混乱的绝佳方法。它使交换对于可能从中学到东西的未来用户来说是可读的。它还可以作为一个方便的指示器来查看是否有任何问题不得到任何答复,进一步增加所有问题得到答案的机会。
请记住,每个人都是来学习的,每个人都从某个地方开始。在你的线索式回复中保持尊重。
同样,每个人都很忙——阅读有结构、代码格式适当的东西要容易得多。这适用于问题和回答。阅读Slack 格式化指南有关如何格式化消息的更多 Slack 特定信息。
使用浏览器的集成拼写检查器,并花一些时间使您的书写清晰。不要担心语法是否遵循学校老师告诉您的内容,特别是如果英语不是您的母语。
不过,格式化很重要的是代码。如前所述,代码很难阅读。因此,您可以做的每一件让代码更易于阅读的小事都会大有帮助。有四种方式您可以在 Slack 上共享格式化代码:
-
内联代码:适用于一到五个的小片段字代码的
-
代码块:适用于一到十个小片段线代码的
-
代码片段(首选方法):对于最多三十行的片段
-
GitHub:对于超过三十行的任何内容
每个都有其用例,但最常见的方法应该是使用代码片段。
内联代码
内联代码用于格式化您想在问题或评论中提及的小段代码。主要是为了突出具体的内容变量和物体在你的问题中:
的话Flask
, ModuleNotFoundError
, 和pip install flask
格式为内联代码。
要将内联代码添加到您的问题中,请将变量或对象名称用反引号 (`) 括起来,或者单击代码消息编辑器上的格式化按钮:
只需选择应格式化为代码的文本,然后按按钮。
代码块
您可以使用代码块小代码示例就像单一功能一样,REPL和终端输出以及短代码摘录。
下面是一个使用内联代码后跟代码块的示例问题:
该问题本身使用对象和变量名称的内联代码,后面是显示相关代码的代码块。要创建代码块,请将代码用三个反引号 ( ``` ) 括起来或单击代码块Slack 消息编辑器中的按钮:
代码块非常适合显示十行或更少的代码。出于以下几个原因,代码块不适合较长的代码:
- 有没有语法高亮,这使得长段代码更难以阅读。
- 它充满了整个屏幕,这意味着其他成员的问题可能会被掩盖或错过了。
- 它使得不愉快的阅读体验对于任何滚动浏览提要的人。
如果您需要共享较大部分的代码,那么有一个更好的方法:代码片段!
代码片段 - 共享代码的最佳方式
代码片段使在 Slack 中共享和阅读大部分代码成为一种更加愉快的体验。片段应该是您共享大部分代码的首选方法。您所需要做的就是附上一个.py
文件到您的留言!
笔记:根据您的系统,以及您是否从 Web 客户端、桌面应用程序或移动应用程序与 Slack 交互,您可以简单地将文件拖放到 Slack 窗口中。否则,您可以使用以下步骤附加文件。
您可以在代码片段消息中使用内联代码和代码块。这种灵活性意味着您可以在一条消息中共享代码和回溯。
这是代码片段的示例:
使用代码片段的一个显着好处是它们支持代码语法高亮几乎适用于任何编程语言。它们也是可折叠的,从而减少长代码示例的干扰。感兴趣的成员只需单击一下即可展开并阅读整个片段。
另一个巨大的优势是它们还可下载,因此任何帮助您的人都可以下载该文件。能够下载该文件可以更快地重现您的问题。
要创建代码片段,请单击+
Slack 消息区域中的按钮,就像您要添加附件一样。然后,您可以附加任何代码文件,该文件将显示为片段。
您还可以搜索名为的快捷方式创建文本片段,这将打开一个叠加层,您可以在其中键入您的问题并将代码复制到内容区域。您可以为代码片段指定一个标题(您可以将其视为文件名)并选择语法突出显示的语言。
以下是如何创建代码片段的快速演示:
代码片段是在 Slack 上共享代码的最佳方式!
笔记:如果您想加倍努力,那么您还可以记录编程视频它会遍历代码并提供更多上下文。这确实可以帮助您的程序员同事更好地理解您的问题。
如果您对在 Slack 中格式化代码有任何其他疑问,请在下面的评论中写下您的想法,或联系 Real Python Community Slack 上的任何管理员。
GitHub
如果用不到三十行代码制作一个可重现的示例很复杂,或者帮助您的人需要访问all您的代码,然后请分享您项目的链接Git 存储库反而。您可以创建一个新的存储库并复制重现问题所需的最少代码:
如果有任何设置说明,请将其记录在README.md
文件。这样,有人就能够快速复制您的工作环境。
GitHub 允许您拥有无限的公共存储库,因此这是一次性存储库的绝佳场所,您可以在找到解决方案后将其删除。
如果创建整个存储库看起来太多,那么中间的解决方案是使用GitHub 要点:
Gists 允许您共享一个或多个文件,而不需要整个存储库的额外样板。
删除和编辑您的帖子
最初发布后,您可以在有限的时间内编辑帖子,但不久之后,您将无法更改它们。您可以随时在帖子下方的帖子中发布更多背景信息、说明或更正——没有限制。
如果您的帖子太过分了或者您犯了一个错误,并且您确实必须从头开始,请联系其中一位管理员,他们可以为您删除帖子。他们将无法编辑不过你的问题。
这种限制主要是因为人们在得到答案后删除问题是很常见的。虽然这是可以理解的,但即使您没有参与,阅读问答主题也很有价值。旧线程是整个社区的宝贵资源。
加起来
参与像 Real Python Slack 这样充满活力的社区可以为您作为开发者的旅程带来巨大的好处。在本指南中,您学习了如何充分利用 Real Python Slack。
学习如何沟通您的技术问题是成为熟练开发人员的重要一步。本指南将帮助您实现这一目标,以便您可以开始利用 Real Python 成员广泛的知识库。
Real Python 社区是多元化的,拥有来自全球各地不同背景和经验的成员。与 Real Python 社区联系将增强您的能力技术能力,让你接触新的兴趣范围,并扩大你的社交网络.
与同行交流也不仅仅是一种在线活动。 Real Python 的展位位于PyCon 2022并结识了很多会员。有聚会和开放空间,成员可以在这里提问和闲逛。
也许你还不是真正的Python成员并且无法利用Slack社区的好处。报名立即注册一个帐户,与您的同行联系并开始提升您的 Python 知识和职业生涯!