标签: code-comments

我正在努力加快我目前正在处理的网站的响应时间.任何人都可以告诉我,如果php解析器花时间查看注释块中的代码,还是完全忽略它？我问,因为我想知道删除许多大块注释代码是否会做任何事情来改善页面渲染时间.谢谢.

Qt Creator通常将注释颜色设置为绿色,但我在Qt示例中看到了蓝色的注释,而Qt Creator似乎为每个//!以蓝色开头的注释着色.

这是一个示例屏幕截图:

这是一些惯例吗？蓝色表示什么？

当我认识到中心评论时,我正在浏览GitHub上的一个开发代码.起初我觉得有人觉得今天做了一个非常好看和花哨的评论,然后我意识到他们在整个项目中被使用了.

这是我见过的一个例子:

    /*
     * =============================================================
     * ================ WORLD CREATION AND LOADING =================
     * =============================================================
     */

我问开发聊天,似乎没有人知道它来自哪里.有人可以告诉我是否可以将所有注释重新格式化为这样,或者可能将其添加为IDE(IntelIj)中的格式化程序.

我注意到我们系统中的一些源文件存在差异,其中一些包含源代码控制签入注释,而另一些则没有.签入时,这些注释会自动添加到文件顶部:

    * $Log:   //vm1/Projects/Morpheus/Sleep.bdy-arc  $
--
--   Rev 1.14   Apr 14 2009 15:32:52   John Smith
--Fixed bugs 2292 and 2230.

这似乎在我所有的工作中都非常出色,但我必须承认我很难看到这一点.一般来说,这些评论并不那么好,而且很久以前就已经离开了人们,即使他们的标准很高,也很难将它们与物理代码的变化联系起来.

它也让我感到震惊的是,你正在改变你正在检查的文件.现在,这对于将被编译的文件可能不是一个问题,但可能是其他人的灾难,例如JavaScript文件.

实际上,我的问题是在第一个实例中提供此功能背后的概念动机是什么？有没有人真正发现这些评论有用？

此外,我很想知道这是否是源控制系统中通常支持的功能.我知道它有PVCS,VSS和Subversion(Subversion关键字替换),但是我想知道它是否也可用于一些比较流行的DVCS.

一如既往,非常感谢您的帮助.

我从事多个ASP.NET/SharePoint C#项目.在开发过程中,我们会使用精心评论来更好地理解.但在我想要发布版本之前,我想要隐藏所有注释(而不是删除它们).有没有VS插件或一些工具来做到这一点？

我希望有一个命令来切换 python代码的行/块中的注释.

我在我的.vimrc文件中使用以下代码:

" (un-)commenting
" comment line, selection with Ctrl-N,Ctrl-N
au BufEnter *.py nnoremap ,c mn:s/^\(\s*\)#*\(.*\)/\1#\2/ge<CR>:noh<CR>`n
au BufEnter *.py inoremap ,c <C-O>mn<C-O>:s/^\(\s*\)#*\(.*\)/\1#\2/ge<CR><C-O>:noh<CR><C-O>`n
au BufEnter *.py vnoremap ,c mn:s/^\(\s*\)#*\(.*\)/\1#\2/ge<CR>:noh<CR>gv`n
"
" " uncomment line, selection with Ctrl-N,N
au BufEnter *.py nnoremap ,u mn:s/^\(\s*\)#\([^ ]\)/\1\2/ge<CR>:s/^#$//ge<CR>:noh<CR>`n
au BufEnter *.py inoremap ,u <C-O>mn<C-O>:s/^\(\s*\)#\([^ ]\)/\1\2/ge<CR><C-O>:s/^#$//ge<CR><C-O>:noh<CR><C-O>`n
au BufEnter *.py vnoremap ,u mn:s/^\(\s*\)#\([^ ]\)/\1\2/ge<CR>gv:s/#\n/\r/ge<CR>:noh<CR>gv`n

(改编自此StackOverflow条目)

但是,你是一种进行切换的方法,也就是说,如果它被注释,则使用相同的快捷方式进行注释,如果它被注释,则取消注释？