拒绝臃肿:长字符串编写的艺术与技巧

前言

日常开发中,总会遇到代码中需要写一下字符串字面量的地方,长的字符串在代码中总是显的格格不入,如何变得更加优雅呢?

遇到超长字符串写么写优雅

PEP8规范建议每行字符数不超过79,但实际编码过程中,会大于79,但也不会太长,否则影响阅读。看如下代码

ini 复制代码
s = "这个函数是一个私有方法,用于构建HTTP请求的有效载荷(payload)。它接受一个字典作为参数,其中包含发送HTTP请求所需的各种信息,如请求路径、请求方法、请求头、Cookie、认证信息等。函数将这些信息组装成一个字典,并返回该字典作为有效载荷。"

我们常用的方法应该是用\拆分为几段,像这样

makefile 复制代码
s = "这个函数是一个私有方法,用于构建HTTP请求的有效载荷(payload)。" \
    "它接受一个字典作为参数,其中包含发送HTTP请求所需的各种信息,如请求路径、请求方法、请求头、Cookie、认证信息等。" \
    "函数将这些信息组装成一个字典,并返回该字典作为有效载荷。"

接下来,就是重点了,有一种更加简单的办法,使用括号将字符串包起来,就可以随意这行了,像这样

makefile 复制代码
s = ("这个函数是一个私有方法,用于构建HTTP请求的有效载荷(payload)。"
     "它接受一个字典作为参数,其中包含发送HTTP请求所需的各种信息,如请求路径、请求方法、请求头、Cookie、认证信息等。"
     "函数将这些信息组装成一个字典,并返回该字典作为有效载荷。")

遇到多级缩进出现多行字符串怎么写优雅

在已经有缩进层级的代码里,插入字符串字面量,为了不让字符串包含缩进中的空格,我们需要这样写,像这样

ini 复制代码
def demo():
    config_content =  """env: test
test:
  host: 'https://test.example.com'
  account:
    user: 'admin'
    pwd: '123456'"""

但这样看着比较难受,破坏了缩进的视觉效果,那该如何做呢?当然,第一种办法可以将多行字符串提取为全局变量,当然还有另外一种办法,使用textwrap标准库解决,像这样

python 复制代码
from textwrap import dedent
def demo():
    config_content = dedent("""
    env: test
        test:
          host: 'https://test.example.com'
          account:
            user: 'admin'
            pwd: '123456'
            """)

该不该使用+=拼接字符串

我在实际写代码过程中,遇到字符串拼接一般都用"".join(),一般不使用+=,因为在我一直认为+=会很慢,那到底慢不慢呢?我们来测试一下

scss 复制代码
import timeit
​
WORDS = ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l','m', 'n', 'o', 'p', 'q', 'r','s', 't', 'u', 'v', 'w', 'x', 'y', 'z'] * 25
# 定义测试函数
def string_concatenation():
    s = ''
    for word in WORDS:
        s += word
    return s
​
def string_concatenation_join():
    l = []
    for word in WORDS:
        l.append(word)
    return ''.join(l)
​
​
time_cost = timeit.timeit(string_concatenation)
time_cost_join = timeit.timeit(string_concatenation_join)
print("Time cost:", time_cost)
print("Time cost join:", time_cost_join)
​

这里我们使用内置模块timeit来测试代码的执行效率。在笔者的MAC笔记本上执行结果如下:

sql 复制代码
Time cost: 32.474184429
Time cost join: 36.23991483099999

看结果,+=居然还会快一些,所以该使用+=就使用吧,大部分场景中都不会有任何问题,上面的示例中可是默认执行了1000000次的。

最后

照着上面的方法改进代码后,代码变得清爽很多,你也可以试着优化一下,让自己的代码变得更优雅,更易阅读吧。

相关推荐
w***74403 小时前
SpringBoot项目如何导入外部jar包:详细指南
spring boot·后端·jar
二川bro4 小时前
量子计算入门:Python量子编程基础
python
夏天的味道٥5 小时前
@JsonIgnore对Date类型不生效
开发语言·python
tsumikistep5 小时前
【前后端】接口文档与导入
前端·后端·python·硬件架构
小白学大数据6 小时前
Python爬虫伪装策略:如何模拟浏览器正常访问JSP站点
java·开发语言·爬虫·python
码事漫谈6 小时前
为什么C语言拒绝函数重载?非要重载怎么做?
后端
码事漫谈6 小时前
浅谈C++与C语言二进制文件差异(从一次链接错误说起)
后端
头发还在的女程序员7 小时前
三天搞定招聘系统!附完整源码
开发语言·python
温轻舟7 小时前
Python自动办公工具06-设置Word文档中表格的格式
开发语言·python·word·自动化工具·温轻舟
花酒锄作田7 小时前
[python]FastAPI-Tracking ID 的设计
python·fastapi